Enable-PSSessionConfiguration
啟用本地電腦的會話設定。
語法
Default (預設值)
Enable-PSSessionConfiguration
[[-Name] <String[]>]
[-Force]
[-SecurityDescriptorSddl <String>]
[-SkipNetworkProfileCheck]
[-NoServiceRestart]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
此 Cmdlet 只能在 Windows 平臺上使用。
cmdlet Enable-PSSessionConfiguration 可啟用已停用的註冊會話設定，例如使用 Disable-PSSessionConfiguration or Disable-PSRemoting cmdlets，或 的 Register-PSSessionConfigurationAccessMode 參數。 這是一個進階指令小程式，設計給系統管理員用來管理使用者自訂的會話設定。
若無參數，Enable-PSSessionConfiguration 可啟用 Microsoft。PowerShell 設定，這是用於會話的預設設定。
Enable-PSSessionConfiguration 移除受影響會話設定的安全描述符中的 Deny_All 設定，開啟接受任意 IP 位址請求的監聽器，並重新啟動 WinRM 服務。 從 PowerShell 3.0 開始，Enable-PSSessionConfiguration也會將會話設定WSMan:\<computer>\PlugIn\<SessionConfigurationName>\Enabled的 Enabled 屬性（）設為 True。 然而，並Enable-PSSessionConfiguration未移除或更改僅允許本地電腦使用者使用會話設定的 Network_Deny_AllAccessMode=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 |
| 別名: | 參見 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Force
表示指令檔不會提示你確認，且會自動重啟 WinRM 服務，且不會提示。 重新啟動服務後，設定變更才會有效。
為了防止重新啟動並抑制重新啟動提示，請使用 NoServiceRestart 參數。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Name
指定要啟用的會話設定名稱。 輸入一個或多個設定名稱。 允許使用通配符字元。
你也可以將包含組態名稱或會話組態物件的字串接到 Enable-PSSessionConfiguration。
若省略此參數，Enable-PSSessionConfiguration 會啟用 Microsoft。PowerShell session configuration.
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | True |
| 不要顯示: | False |
參數集
(All)
| Position: | 0 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-NoServiceRestart
表示指令長不會重新啟動服務。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SecurityDescriptorSddl
指定一個安全描述符，該 cmdlet 用來取代會話設定上的安全描述符。
若省略此參數， Enable-PSSessionConfiguration 則只會從安全描述符中刪除「deny all 項目」。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SkipNetworkProfileCheck
表示此指令檔在電腦處於公共網路時啟用會話設定。 此參數允許公共網路的防火牆規則，允許同一本地子網內的電腦遠端存取。 預設情況下， Enable-PSSessionConfiguration 在公共網路上會失敗。
此參數是為 Windows 作業系統的用戶端版本設計的。 Windows 作業系統的伺服器版本則有針對公共網路的本地子網防火牆規則。 然而，若在 Windows 作業系統的伺服器版本中禁用了本地子網路防火牆規則，該參數會重新啟用該規則。
要解除本地子網限制並啟用公共網路中所有地點的遠端存取，請使用 Set-NetFirewallRule NetSecurity 模組中的 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
你可以將一個 session configuration 物件管道連接到這個 cmdlet。
String
你可以將包含會話組名稱的字串輸入這個 cmdlet。
輸出
None
此 Cmdlet 不會傳回任何輸出。
備註
此 Cmdlet 僅適用於 Windows 平臺。
要使用此 cmdlet，您必須透過「 以管理員身份執行 」選項啟動 PowerShell。
