Получает зарегистрированные конфигурации сеансов на компьютере.

Синтаксис

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

Описание

Командлет Get-PSSessionConfiguration получает конфигурации сеансов, зарегистрированные на локальном компьютере. Этот расширенный командлет предназначен для использования системными администраторами и позволяет управлять конфигурациями сеансов для пользователей.

Чтобы создать и зарегистрировать конфигурацию сеанса, используйте командлет Register-PSSessionConfiguration.

Параметры

-Name <string[]>

Получает только конфигурации сеансов с указанным именем или шаблоном имени. Введите одно или несколько имен конфигураций сеансов. Подстановочные знаки разрешены.

Обязательно?

false

Позиция?

1

Значение по умолчанию

All session configurations on the local computer

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

true

<CommonParameters>

Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.

Ввод и вывод

Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.

Входные данные

None

Передать входные данные этому командлету по конвейеру невозможно.

Выходные данные

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands#PSSessionConfiguration

Примечания

Чтобы использовать этот командлет в Windows Vista, Windows Server 2008 и более поздних версиях Windows, необходимо запускать Windows PowerShell командой "Запуск от имени администратора".

Чтобы просмотреть конфигурации сеансов на компьютере, необходимо быть членом группы "Администраторы" на этом компьютере.

Чтобы выполнить команду Get-PSSessionConfiguration на удаленном компьютере, проверка подлинности поставщика услуг безопасности (CredSSP) должна быть включена в параметрах клиента на локальном компьютере (с помощью командлета Enable-WSManCredSSP) и в параметрах службы на удаленном компьютере; кроме того, при установке удаленного сеанса для параметра Authentication необходимо использовать значение CredSSP. В противном случае в доступе будет отказано.

Пример 1

C:\PS>get-pssessionconfiguration

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






Пример 2

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.






Пример 3

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) конфигурации.






Пример 4

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.






Пример 5

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.






Пример 6

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.






См. также




Содержание