Get-PSSessionConfiguration

Get-PSSessionConfiguration [[-Name] <string[]>] [<CommonParameters>]

C:\PS>get-pssessionconfiguration

Description
-----------
Эта команда возвращает конфигурации сеансов на компьютере.

C:\PS>get-pssessionconfiguration -name Microsoft*

Name                      PSVersion  StartupScript        Permission
----                      ---------  -------------        ----------
microsoft.powershell      2.0                             BUILTIN\Administrators AccessAll...
microsoft.powershell32    2.0                             BUILTIN\Administrators AccessAll...

Description
-----------
Эта команда использует параметр Name командлета Get-PSSessionConfiguration, чтобы получить конфигурации сеансов с именами, которые начинаются с "Microsoft".

Эта команда возвращает две конфигурации сеансов по умолчанию Windows PowerShell.

C:\PS>Get-PSSessionConfiguration -name microsoft.powershell | get-member



   TypeName: Microsoft.PowerShell.Commands.PSSessionConfigurationCommands#PSSessionConfiguration

Name                   MemberType     Definition
----                   ----------     ----------
Equals                 Method         bool Equals(System.Object obj)
GetHashCode            Method         int GetHashCode()
GetType                Method         type GetType()
ToString               Method         string ToString()
Capability             NoteProperty   System.Object[] Capability=System.Object[]
ExactMatch             NoteProperty   System.String ExactMatch=False
Filename               NoteProperty   System.String Filename=%windir%\system32\pwrshplugin.dll
lang                   NoteProperty   System.String lang=en-US
Name                   NoteProperty   System.String Name=microsoft.powershell
PSVersion              NoteProperty   System.String PSVersion=2.0
ResourceUri            NoteProperty   System.String ResourceUri=https://schemas.microsoft.com/powershell/microsoft.powershell
SDKVersion             NoteProperty   System.String SDKVersion=1
SecurityDescriptorSddl NoteProperty   System.String SecurityDescriptorSddl=O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;SA;GXGW;;;WD)
SupportsOptions        NoteProperty   System.String SupportsOptions=true
Uri                    NoteProperty   System.String Uri=https://schemas.microsoft.com/powershell/microsoft.powershell
xmlns                  NoteProperty   System.String xmlns=https://schemas.microsoft.com/wbem/wsman/1/config/PluginConfiguration
XmlRenderingType       NoteProperty   System.String XmlRenderingType=text
Permission             ScriptProperty System.Object Permission {get=trap { continue; }...


C:\PS> Get-PSSessionConfiguration -name microsoft.powershell | format-list -property *


Name                   : microsoft.powershell
Filename               : %windir%\system32\pwrshplugin.dll
SDKVersion             : 1
XmlRenderingType       : text
lang                   : en-US
PSVersion              : 2.0
ResourceUri            : https://schemas.microsoft.com/powershell/microsoft.powershell
SupportsOptions        : true
Capability             : {Shell}
Uri                    : https://schemas.microsoft.com/powershell/microsoft.powershell
SecurityDescriptorSddl : O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;SA;GXGW;;;WD)
ExactMatch             : False
xmlns                  : https://schemas.microsoft.com/wbem/wsman/1/config/PluginConfiguration
Permission             : BUILTIN\Administrators AccessAllowed

Description
-----------
Эти команды проверяют объект PSSessionConfiguration, который возвращается Get-PSSessionConfiguration.

Первая команда использует командлет Get-PSSessionConfiguration для получения конфигурации по умолчанию Microsoft.PowerShell.

Вторая команда с помощью оператора конвейера (|) передает объект, который Get-PSSessionConfiguration возвращает командлету Get-Member. На выходе отображаются свойства и методы объекта.

Третья команда передает этот же объект командлету Format-List. Параметр Property со значением * (все) указывает команде Format-List отобразить все свойства и значения свойств объекта в списке.

В результате выполнения этой команды выводятся очень полезные сведения, в том числе местоположение DLL, реализующего тип конфигурации, URI ресурса создаваемой конечной точки и язык определения дескрипторов безопасности (SDDL) конфигурации.

C:\PS>dir wsman:\localhost\plugin

   WSManConfig: Microsoft.WSMan.Management\WSMan::localhost\Plugin

Name                      Type                 Keys
----                      ----                 ----
Event Forwarding Plugin   Container            {Name=Event Forwarding Plugin}
MaintenanceShell          Container            {Name=MaintenanceShell}
microsoft.powershell      Container            {Name=microsoft.powershell}
microsoft.powershell32    Container            {Name=microsoft.powershell32}
WMI Provider              Container            {Name=WMI Provider}

Description
-----------
Эта команда использует командлет Get-ChildItem (с псевдонимом "dir") на WSMan: — диске поставщика, на котором просматривается содержимое узла Plugin.

Это еще один способ просмотреть конфигурации сеансов на компьютере.

Узел PlugIn содержит объекты ContainerElement (Microsoft.WSMan.Management.WSManConfigContainerElement), представляющие зарегистрированные конфигурации сеансов Windows PowerShell с другими подключаемыми модулями WS-Management.

C:\PS>enable-wsmanCredSSP -delegate server02

C:\PS> connect-wsman server02

C:\PS> set-item wsman:\server02*\service\auth\credSSP -value $true

C:\PS> invoke-command -scriptblock {Get-PSSessionConfiguration} -computername Server02 -authentication CredSSP -credential Domain01\Admin01 

Name                      PSVersion  StartupScript        Permission                          PSComputerName
----                      ---------  -------------        ----------                          --------------
microsoft.powershell      2.0                             BUILTIN\Administrators AccessAll... server02.corp.fabrikam.com
microsoft.powershell32    2.0                             BUILTIN\Administrators AccessAll... server02.corp.fabrikam.com
MyX86Shell                2.0        c:\test\x86Shell.ps1 BUILTIN\Administrators AccessAll... server02.corp.fabrikam.com

Description
-----------
В этом примере показано, как выполнить команду Get-PSSessionConfiguration на удаленном компьютере. Для выполнения команды необходимо включить делегирование CredSSP в параметрах клиента на локальном компьютере и в параметрах службы на удаленном компьютере. Для выполнения команд в этом примере текущий пользователь должен быть членом группы "Администраторы" на локальном и удаленном компьютере.

Первая команда использует командлет Enable-WSManCredSSP для включения делегирования CredSSP с локального компьютера Server01 на удаленном компьютере Server02. Это позволяет настроить параметр клиента CredSSP на локальном компьютере.

Вторая команда использует командлет Connect-WSMan для подключения к компьютеру Server02. Это действие добавляет узел для компьютера Server02 на диск WSMan: — диск на локальном компьютере, позволяя просматривать и изменять параметры WS-Management на компьютере Server02.

Третья команда использует командлет Set-Item для изменения значения элемента CredSSP в узле службы компьютера Server02 на значение "True". Таким образом выполняется настройка параметров службы на удаленном компьютере.

Четвертая команда использует командлет Invoke-Command для выполнения команды Get-PSSessionConfiguration на компьютере Server02. Команда использует параметр Credential и параметр Authentication со значением CredSSP.

C:\PS>(get-PSSessionConfiguration -name CustomShell).resourceURI

https://schemas.microsoft.com/powershell/microsoft.CustomShell

Description
-----------
Эта команда с помощью командлета Get-PSSessionConfiguration получает URI ресурса конфигурации сеанса. 

Эта команда полезна при задании значения привилегированной переменной $PSSessionConfigurationName, получающей URI ресурса. 

Переменная $PSSessionConfiguationName задает конфигурацию по умолчанию, которая используется при создании сеанса. Эта переменная задается на локальном компьютере, но указывает конфигурацию на удаленном компьютере. Дополнительные сведения о переменной $PSSessionConfiguration см. в разделе about_Preference_Variables.