Set-PSSessionConfiguration

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 cmdlet을 사용하여 AdminShell 구성을 만듭니다. 

두 번째 명령은 Set-PSSessionConfiguration cmdlet을 사용하여 AdminConfig.ps1 스크립트를 구성에 추가합니다. 변경 내용은 WinRM을 다시 시작할 때 적용됩니다.

세 번째 명령은 AdminConfig.ps1 스크립트를 구성에서 제거합니다. 이 명령은 StartupScript 매개 변수에 대해 $null 값을 지정하여 Set-PSSessionConfiguration cmdlet을 사용합니다.

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 cmdlet의 샘플 출력을 보여 줍니다. 

이 예의 Set-PSSessionConfiguration 명령은 MaximumReceivedObjectSizeMB 속성의 값을 20으로 늘립니다. 

Set-PSSessionConfiguration 명령은 매개 변수 이름과 새 값을 표시하는 Microsoft.WSMan.Management.WSManConfigLeafElement 개체를 반환합니다.

또한 WinRM 서비스를 다시 시작하라는 메시지를 표시합니다. WinRM 서비스를 다시 시작해야 Set-PSSessionConfiguration 변경 내용이 적용됩니다.

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            : https://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      : https://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 cmdlet을 사용하여 MaintenanceShell 구성의 시작 스크립트를 Maintenance.ps1로 변경합니다. 이 명령의 출력에는 변경 내용과 WinRM 서비스를 다시 시작하라는 메시지가 표시됩니다. "y"(예)로 응답하십시오.

두 번째 명령은 Get-PSSessionConfiguration cmdlet을 사용하여 MaintenanceShell 세션 구성을 가져옵니다. 명령이 파이프라인 연산자(|)를 사용하여 명령의 결과를 Format-List cmdlet으로 보내고, 이 cmdlet은 세션 구성 개체의 모든 속성을 목록으로 표시합니다.

세 번째 명령은 WS-Management 공급자를 사용하여 MaintenanceShell 구성에 대한 초기화 매개 변수를 표시합니다. 이 명령은 Get-ChildItem cmdlet(별칭 = dir)을 사용하여 MaintenanceShell 플러그인에 대한 InitializationParameters 노드의 하위 항목을 가져옵니다.

WS-Management 공급자에 대한 자세한 내용을 보려면 "get-help wsman"을 입력하십시오.