Enable-PSSessionConfiguration

參考

模組:: Microsoft.PowerShell.Core

啟用本機電腦上的工作階段設定。

Syntax

Enable-PSSessionConfiguration
      [[-Name] <String[]>]
      [-Force]
      [-SecurityDescriptorSddl <String>]
      [-SkipNetworkProfileCheck]
      [-NoServiceRestart]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

此 Cmdlet 僅適用於 Windows 平臺。

Cmdlet Enable-PSSessionConfiguration 會啟用已停用的已註冊會話組態，例如使用 Disable-PSSessionConfiguration 或 Disable-PSRemoting Cmdlet 或的 Register-PSSessionConfigurationAccessMode 參數。這是一個進階的 Cmdlet，專門設計給系統管理員用於管理其使用者的自訂工作階段設定。

如果沒有參數， Enable-PSSessionConfiguration 則啟用 Microsoft.PowerShell 組態，這是用於會話的預設組態。

Enable-PSSessionConfiguration 會從受影響會話組態的安全性描述元中移除 Deny_All 設定、開啟接受任何IP位址要求的接聽程式，然後重新啟動WinRM服務。從 PowerShell 3.0 開始， Enable-PSSessionConfiguration 也會將會話組態的 Enabled 屬性值設定 (WSMan:\<computer>\PlugIn\<SessionConfigurationName>\Enabled) 為 True。不過， Enable-PSSessionConfiguration 不會移除或變更 Network_Deny_All (AccessMode=Local) 只允許本機計算機用戶用於會話設定的安全性描述符設定。

範例

範例 1：重新啟用預設工作階段

本範例會在計算機上重新啟用 Microsoft.PowerShell 預設會話設定。

Enable-PSSessionConfiguration

範例 2：重新啟用指定的工作階段

此範例會在計算機上重新啟用 MaintenanceShell 和 AdminShell 工作階段設定。

Enable-PSSessionConfiguration -Name MaintenanceShell, AdminShell

範例 3：重新啟用所有工作階段

本範例會重新啟用電腦上的所有會話設定。這些命令相等。因此，您可以使用任一項。

Enable-PSSessionConfiguration -Name *
Get-PSSessionConfiguration | Enable-PSSessionConfiguration

Enable-PSSessionConfiguration 如果您啟用已啟用的工作階段組態，則不會產生錯誤。

範例 4：重新啟用會話，並指定新的安全性描述元

此範例會重新啟用 MaintenanceShell 工作階段設定，並指定設定的新安全性描述元。

$sddl = "O:NSG:BAD:P(A;;GXGWGR;;;BA)(A;;GAGR;;;S-1-5-21-123456789-188441444-3100496)S:P"
Enable-PSSessionConfiguration -Name MaintenanceShell -SecurityDescriptorSDDL $sddl

參數

-Confirm

在執行 Cmdlet 前提示您確認。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

指出 Cmdlet 不會提示您進行確認，並會在不提示的情況下重新啟動 WinRM 服務。重新啟動服務可讓設定變更生效。

若要避免重新啟動並抑制重新啟動提示，請使用 NoServiceRestart 參數。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

指定要啟用之工作階段設定的名稱。輸入一或多個設定名稱。允許使用萬用字元。

您也可以使用管線將包含群組態名稱或工作階段組態物件的字串傳送至 Enable-PSSessionConfiguration。

如果您省略此參數， Enable-PSSessionConfiguration 請啟用 Microsoft.PowerShell 會話設定。

Type:	String[]
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	True

-NoServiceRestart

表示 Cmdlet 不會重新啟動服務。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SecurityDescriptorSddl

指定此 Cmdlet 取代會話組態上之安全性描述元的安全性描述元。

如果您省略此參數， Enable-PSSessionConfiguration 則只會刪除安全性描述元中的所有拒絕專案。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipNetworkProfileCheck

指出當電腦位於公用網路上時，此 Cmdlet 會啟用工作階段設定。此參數會針對公用網路啟用防火牆規則，以便只允許從位於相同本機子網路的電腦進行遠端存取。根據預設， Enable-PSSessionConfiguration 公用網路上會失敗。

此參數是針對 Windows 作業系統的用戶端版本所設計。 Windows 作業系統的伺服器版本具有公用網路的本機子網防火牆規則。不過，如果 Windows 作業系統的伺服器版本停用本機子網防火牆規則，此參數會重新啟用它。

若要移除本機子網限制，並從公用網路上的所有位置啟用遠端訪問，請使用 Set-NetFirewallRule NetSecurity 模組中的 Cmdlet。如需詳細資訊，請參閱Enable-PSRemoting。

此參數是在 PowerShell 3.0 中引進。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

輸入

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

您可以使用管線將會話組態物件傳送至此 Cmdlet。

String

您可以使用管線將包含工作階段組態名稱的字串傳送至此 Cmdlet。

輸出

None

此 Cmdlet 不會傳回任何輸出。

備註

此 Cmdlet 僅適用於 Windows 平臺。

若要使用此 Cmdlet，您必須使用 [ 以系統管理員身分執行 ] 選項來啟動 PowerShell。