Enable-PSSessionConfiguration
啟用本機電腦上的工作階段設定。
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-PSSessionConfiguration
AccessMode 參數。 這是一個進階的 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。
您可以使用管線將包含工作階段組態名稱的字串傳送至此 Cmdlet。
輸出
None
此 Cmdlet 不會傳回任何輸出。
備註
此 Cmdlet 僅適用於 Windows 平臺。
若要使用此 Cmdlet,您必須使用 [ 以系統管理員身分執行 ] 選項來啟動 PowerShell。
相關連結
- Disable-PSSessionConfiguration
- Get-PSSessionConfiguration
- New-PSSessionConfigurationFile
- New-PSSessionOption
- Register-PSSessionConfiguration
- Set-PSSessionConfiguration
- Test-PSSessionConfigurationFile
- Unregister-PSSessionConfiguration
- WSMan 提供者
- about_Session_Configurations
- about_Session_Configuration_Files