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 脚本从该配置中删除。该命令使用 Set-PSSessionConfiguration cmdlet，并将 StartupScript 参数的值设置为 $null。

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 服务。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            : 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”。