Set-PSSessionConfiguration

Set-PSSessionConfiguration
    [-Name] <String>
    [-ApplicationBase <String>]
    [-RunAsCredential <PSCredential>]
    [-ThreadApartmentState <ApartmentState>]
    [-ThreadOptions <PSThreadOptions>]
    [-AccessMode <PSSessionConfigurationAccessMode>]
    [-UseSharedProcess]
    [-StartupScript <String>]
    [-MaximumReceivedDataSizePerCommandMB <Double>]
    [-MaximumReceivedObjectSizeMB <Double>]
    [-SecurityDescriptorSddl <String>]
    [-ShowSecurityDescriptorUI]
    [-Force]
    [-NoServiceRestart]
    [-PSVersion <Version>]
    [-SessionTypeOption <PSSessionTypeOption>]
    [-TransportOption <PSTransportOption>]
    [-ModulesToImport <Object[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Set-PSSessionConfiguration
    [-Name] <String>
    [-AssemblyName] <String>
    [-ConfigurationTypeName] <String>
    [-ApplicationBase <String>]
    [-RunAsCredential <PSCredential>]
    [-ThreadApartmentState <ApartmentState>]
    [-ThreadOptions <PSThreadOptions>]
    [-AccessMode <PSSessionConfigurationAccessMode>]
    [-UseSharedProcess]
    [-StartupScript <String>]
    [-MaximumReceivedDataSizePerCommandMB <Double>]
    [-MaximumReceivedObjectSizeMB <Double>]
    [-SecurityDescriptorSddl <String>]
    [-ShowSecurityDescriptorUI]
    [-Force]
    [-NoServiceRestart]
    [-PSVersion <Version>]
    [-SessionTypeOption <PSSessionTypeOption>]
    [-TransportOption <PSTransportOption>]
    [-ModulesToImport <Object[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Set-PSSessionConfiguration
    [-Name] <String>
    -Path <String>
    [-RunAsCredential <PSCredential>]
    [-ThreadApartmentState <ApartmentState>]
    [-ThreadOptions <PSThreadOptions>]
    [-AccessMode <PSSessionConfigurationAccessMode>]
    [-UseSharedProcess]
    [-StartupScript <String>]
    [-MaximumReceivedDataSizePerCommandMB <Double>]
    [-MaximumReceivedObjectSizeMB <Double>]
    [-SecurityDescriptorSddl <String>]
    [-ShowSecurityDescriptorUI]
    [-Force]
    [-NoServiceRestart]
    [-TransportOption <PSTransportOption>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

此 cmdlet 仅在 Windows 平台上可用。

Set-PSSessionConfiguration cmdlet 更改本地计算机上的会话配置的属性。

使用 Name 参数标识要更改的会话配置。 使用其他参数为会话配置的属性指定新值。 若要从配置中删除属性值并使用默认值，请输入空字符串（""）或相应参数的 $null 值。

从 PowerShell 3.0 开始，可以使用会话配置文件来定义会话配置。 此功能提供了一种简单且可发现的方法，用于设置和更改使用会话配置的会话的属性。 若要指定会话配置文件，请使用 的 Set-PSSessionConfiguration 参数。 有关会话配置文件的信息，请参阅 about_Session_Configuration_Files。 有关如何创建和修改会话配置文件的信息，请参阅 New-PSSessionConfigurationFile cmdlet。

会话配置定义连接到本地计算机的远程会话（PSSessions）的环境。 PSSession 每个 都使用会话配置。 会话配置确定 PSSession的功能，例如会话中可用的模块、允许运行的 cmdlet、语言模式、配额和超时。 会话配置的安全描述符确定谁可以使用会话配置连接到本地计算机。 有关会话配置的详细信息，请参阅 about_Session_Configurations。

若要查看会话配置的属性，请使用 Get-PSSessionConfiguration cmdlet 或 WSMan 提供程序。 有关 WSMan 提供程序的详细信息，请键入 Get-Help WSMan。

此示例演示如何从配置中添加和删除启动脚本。

第一个命令创建 AdminShell 配置。 第二个命令将 AdminConfig.ps1 脚本添加到配置。 在重启 winRM时，更改有效。 第三个命令从配置中删除 AdminConfig.ps1 脚本。

Register-PSSessionConfiguration -Name "AdminShell" -AssemblyName "C:\Shells\AdminShell.dll" -ConfigurationTypeName "AdminClass"
Set-PSSessionConfiguration -Name "AdminShell" -StartupScript "AdminConfig.ps1"
Set-PSSessionConfiguration -Name "AdminShell" -StartupScript $null

此示例将 MaximumReceivedObjectSizeMB 属性的值增加到 20。 此命令还会提示重启 WinRM 服务。 在重新启动 winRM 服务 之前，更改才有效。

Set-PSSessionConfiguration -Name "IncObj" -MaximumReceivedObjectSizeMB 20

WSManConfig: Microsoft.WSMan.Management\WSMan::localhost\Plugin\IncObj\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 将 MaintenanceShell 中的启动脚本 会话配置更改为 Maintenance.ps1。 输出显示更改并提示重启 WinRM 服务。 响应 y（是）。

Get-PSSessionConfiguration 获取 MaintenanceShell 会话配置。 管道运算符（|）将命令的结果发送到 Format-List，该结果显示列表中配置对象的所有属性。 接下来，使用 WSMan 提供程序查看 MaintenanceShell 配置的初始化参数。 Get-ChildItem 获取 MaintenanceShell 插件的 InitializationParameters 节点中的子项。 有关 WSMan 提供程序的详细信息，请键入 Get-Help WSMan。

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

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       :

Get-ChildItem WSMan:\localhost\Plugin\MaintenanceShell\InitializationParameters

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

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

不能用管道将对象传送到此 cmdlet。

此 cmdlet 仅在 Windows 平台上可用。

若要运行此 cmdlet，请使用 以管理员身份运行 选项启动 PowerShell。

Set-PSSessionConfiguration cmdlet 不会更改配置名称，WSMan 提供程序不支持 Rename-Item cmdlet。 若要更改会话配置的名称，请使用 Unregister-PSSessionConfiguration cmdlet 删除配置，然后使用 Register-PSSessionConfiguration cmdlet 创建和注册新的会话配置。

可以使用 Set-PSSessionConfiguration cmdlet 更改默认 Microsoft.PowerShell 和 Microsoft.PowerShell32 会话配置。 它们不受保护。 若要还原到默认会话配置的原始版本，请使用 Unregister-PSSessionConfiguration cmdlet 删除默认会话配置，然后使用 Enable-PSRemoting cmdlet 还原它。

会话配置对象的属性因为会话配置设置的选项以及这些选项的值而有所不同。 此外，使用会话配置文件的会话配置具有其他属性。

可以使用 WSMan: 驱动器中的命令来更改会话配置的属性。 但是，不能在 PowerShell 2.0 中使用 WSMan: 驱动器更改 PowerShell 3.0 中引入的会话配置属性，例如 OutputBufferingMode。 Windows PowerShell 2.0 命令不会生成错误，但它们无效。 若要更改 PowerShell 3.0 中引入的属性，请使用 PowerShell 3.0 或更高版本中的 WSMan: 驱动器。