Set-PSSessionConfiguration [-AssemblyName] <string> [-ConfigurationTypeName] <string> [-Name] <string> [-ApplicationBase <string>] [-Force] [-MaximumReceivedDataSizePerCommandMB <double>] [-MaximumReceivedObjectSizeMB <double>] [-NoServiceRestart] [-SecurityDescriptorSDDL <string>] [-ShowSecurityDescriptorUI] [-StartupScript <string>] [-ThreadApartmentState {<STA> | <MTA> | <Unknown>}] [-ThreadOptions {<Default> | <UseNewThread> | <ReuseThread> | <UseCurrentThread>}] [-Confirm] [-WhatIf] [<CommonParameters>]

C:\PS>set-pssessionconfiguration -name MaintenanceShell -threadApartmentState STA

Описание
-----------
Эта команда изменяет состояние подразделения потоков в конфигурации MaintenanceShell на STA. Изменение вступает в силу после перезапуска службы WinRM.

C:\PS>register-pssessionconfiguration -name AdminShell -assemblyName c:\shells\AdminShell.dll -configurationType AdminClass

C:\PS> set-pssessionconfiguration -name AdminShell -startupScript AdminConfig.ps1

C:\PS> set-pssessionconfiguration -name AdminShell -startupScript $null

Описание
-----------
В этом примере показано, как создать и затем изменить конфигурацию сеанса.

Первая команда с помощью командлета Register-PSSessionConfiguration создает конфигурацию AdminShell. 

Вторая команда с помощью командлета Set-PSSessionConfiguration добавляет в эту конфигурацию скрипт AdminConfig.ps1. Изменение вступает в силу после перезапуска службы WinRM.

Третья команда удаляет из конфигурации скрипт AdminConfig.ps1. В ней используется командлет Set-PSSessionConfiguration со значением "$null" параметра StartupScript.

C:\PS>Set-PSSessionConfiguration -name foo -MaximumReceivedObjectSizeMB 20

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

ParamName					 ParamValue
---------					 ----------
psmaximumreceivedobjectsizemb   20

"Restart WinRM service"
WinRM service need to be restarted to make the changes effective. Do you want to run the command "restart-service winrm"?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): y

Описание
-----------
В этом примере показан пример выходных данных командлета Set-PSSessionConfiguration. 

Команда Set-PSSessionConfiguration в этом примере увеличивает значение свойства MaximumReceivedObjectSizeMB до 20. 

Команда Set-PSSessionConfiguration возвращает объект Microsoft.WSMan.Management.WSManConfigLeafElement и отображает имя параметра и его новое значение.

Кроме того, она выводит запрос на перезапуск службы WinRM. Внесенное командлетом Set-PSSessionConfiguration изменение не вступает в силу, пока служба WinRM не будет перезапущена.

C:\PS>set-pssessionconfiguration -name MaintenanceShell -startupScript c:\ps-test\Maintenance.ps1


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

ParamName			ParamValue
---------			----------
startupscript		c:\ps-test\Mainte...

"Restart WinRM service"
WinRM service need to be restarted to make the changes effective. Do you want to run the command "restart-service winrm"?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): y


C:\PS> get-pssessionConfiguration maintenanceshell | format-list -property *

xmlns			: http://schemas.microsoft.com/wbem/wsman/1/config/PluginConfiguration
Name			 : MaintenanceShell
Filename		 : %windir%\system32\pwrshplugin.dll
SDKVersion	 : 1
XmlRenderingType : text
lang			 : en-US
PSVersion		: 2.0
startupscript	: c:\ps-test\Maintenance.ps1
ResourceUri	: http://schemas.microsoft.com/powershell/MaintenanceShell
SupportsOptions  : true
ExactMatch	 : true
Capability	 : {Shell}
Permission	 :


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

ParamName	 ParamValue
---------	 ----------
PSVersion	 2.0
startupscript c:\ps-test\Maintenance.ps1

Описание
-----------
Эта команда демонстрирует различные способы просмотра результатов выполнения команды Set-PSSessionConfiguration.

Первая команда с помощью командлета Set-PSSessionConfiguration изменяет скрипт запуска в конфигурации MaintenanceShell на Maintenance.ps1. В выходных данных этой команды отражается изменение и содержится запрос на перезапуск службы WinRM. Ответ — "y" (да).

Вторая команда с помощью командлета Get-PSSessionConfiguration получает конфигурацию сеанса MaintenanceShell. Оператор конвейера (|) передает результаты выполнения команды командлету Format-List, который отображает все свойства конфигурации сеанса в виде списка.

В третьей команде используется поставщик WS-Management для просмотра параметров инициализации конфигурации MaintenanceShell. Для получения дочерних элементов в узле InitializationParameters для подключаемого модуля MaintenanceShell используется командлет Get-ChildItem (псевдоним: dir).

Чтобы получить дополнительные сведения о поставщике WS-Management, введите команду "get-help wsman".