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

Синтаксис

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=http://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=http://schemas.microsoft.com/powershell/microsoft.powershell
xmlns				NoteProperty   System.String xmlns=http://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			: http://schemas.microsoft.com/powershell/microsoft.powershell
SupportsOptions		: true
Capability			 : {Shell}
Uri					: http://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				: http://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

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

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

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

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






См. также