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 設定中的執行緒 Apartment 狀態變更為 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 指令碼。它會使用 Set-PSSessionConfiguration Cmdlet 搭配值為 $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 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，並由後者將工作設定物件的所有屬性顯示在清單中。

第三個命令會使用 WS-Management 提供者來檢視 MaintenanceShell 設定的初始化參數。此命令會使用 Get-ChildItem Cmdlet (別名為 dir) 來取得 MaintenanceShell 外掛程式之 InitializationParameters 節點中的子項目。

如需 WS-Management 提供者的詳細資訊，請輸入 "get-help wsman"。