共用方式為

Enable-PSSessionConfiguration

模組:
Microsoft.PowerShell.Core Module

啟用本機電腦上的會話設定。

語法

Default (預設值) 

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

Description

Enable-PSSessionConfiguration Cmdlet 會啟用已停用的已註冊會話組態，例如使用 Disable-PSSessionConfiguration 或 Disable-PSRemoting Cmdlet，或是 的 Register-PSSessionConfiguration 參數。 這是一個進階 Cmdlet，其設計目的是由系統管理員用來管理其使用者的自定義會話設定。

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

Enable-PSSessionConfiguration 會從受影響會話組態的安全性描述元中移除 Deny_All 設定、開啟接受任何IP位址要求並重新啟動WinRM服務的接聽程式。 從 PowerShell 3.0 開始，Enable-PSSessionConfiguration 也會將會話組態 （） 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 之前，提示您進行確認。

參數屬性

類型:SwitchParameter
預設值:False
支援萬用字元:False
不要顯示:False
別名:cf

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Force

指出 Cmdlet 不會提示您進行確認，而且不會提示重新啟動 WinRM 服務。 重新啟動服務會讓設定變更生效。

若要防止重新啟動並隱藏重新啟動提示，請使用 NoServiceRestart 參數。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Name

指定要啟用的工作階段組態名稱。 輸入一或多個組態名稱。 允許使用通配符字元。

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

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

參數屬性

類型:

String[]

預設值:None
支援萬用字元:True
不要顯示:False

參數集

(All)
Position:0
必要:False
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-NoServiceRestart

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

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SecurityDescriptorSddl

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

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SkipNetworkProfileCheck

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

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

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

此參數是在 PowerShell 3.0 中引進的。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 指令未執行。

參數屬性

類型:SwitchParameter
預設值:False
支援萬用字元:False
不要顯示:False
別名:無線

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

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

輸出

None

此 Cmdlet 不會傳回任何物件。

備註

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