Enable-PSSessionConfiguration

發行項
10/30/2009

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

語法

Enable-PSSessionConfiguration [[-Name] <string[]>] [-Force] [-SecurityDescriptorSDDL <string>] [-Confirm] [-WhatIf] [<CommonParameters>]

描述

Enable-PSSessionConfiguration Cmdlet 會重新啟用已經使用 Disable-PSSessionConfiguration Cmdlet 停用的已註冊工作階段設定。這是進階的 Cmdlet，適合系統管理員用來管理使用者的自訂工作階段設定。

如果沒有使用參數，Enable-PSSessionConfiguration 就會重新啟用 Microsoft.PowerShell 設定 (用於工作階段的預設設定)。

這個 Cmdlet 會針對每個啟用的設定執行下列作業：

-- 從設定的安全性描述元中移除「全部拒絕」設定，或以您所指定的安全性描述元取代現有的安全性描述元。

-- 開啟接受任何 IP 位址之要求的接聽程式。

-- 重新啟動 WinRM 服務。

Enable-PSSessionConfiguration Cmdlet 會呼叫 Set-WSManQuickConfig Cmdlet。不過，它不應該用來啟用電腦的遠端功能。請改用 Enable-PSRemoting 這個更完整的 Cmdlet。

參數

-Force

抑制所有使用者提示，並重新啟動 WinRM 服務，而不進行提示。重新啟動服務可讓設定變更生效。

若要防止進行重新啟動並抑制重新啟動的提示，請使用 NoServiceRestart 參數。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

-Name <string[]>

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

您也可以經由管道將包含設定名稱的字串或工作階段設定物件輸出至 Enable-PSSessionConfiguration。

如果您省略這個參數，Enable-PSSessionConfiguration 就會啟用 Microsoft.PowerShell 工作階段設定。

必要?	false
位置?	1
預設值
接受管線輸入?	true (ByValue, ByPropertyName)
接受萬用字元?	true

-SecurityDescriptorSDDL <string>

以指定的安全性描述元取代工作階段設定的安全性描述元。

如果您省略這個參數，Enable-PSSessionConfiguration 只會從安全性描述元中刪除「全部拒絕」項目。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

-Confirm

在執行命令前先提示確認。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

-WhatIf

說明執行命令時將會發生何種情況，但不會實際執行命令。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

<CommonParameters>

這個 Cmdlet 支援一般參數：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊，請參閱 about_Commonparameters.

輸入和輸出

輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。

輸入

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands#PSSessionConfiguration 或 System.String

您可經由管道將工作階段設定物件或包含工作階段設定名稱的字串輸出至 Enable-PSSessionConfiguration。

輸出

無

這個 Cmdlet 不會傳回任何物件。

附註

若要在 Windows Vista、Windows Server 2008 和更新版的 Windows 上執行這個 Cmdlet，您必須使用 [以系統管理員身分執行] 選項啟動 Windows PowerShell。

範例 1

C:\PS>Enable-PSSessionConfiguration

描述
-----------
這個命令會重新啟用電腦上的 Microsoft.PowerShell 預設工作階段設定。

範例 2

C:\PS>Enable-PSSessionConfiguration -name MaintenanceShell, AdminShell

描述
-----------
這個命令會重新啟用電腦上的 MaintenanceShell 和 AdminShell 工作階段設定。

範例 3

C:\PS>Enable-PSSessionConfiguration -name *

C:\PS> Get-PSSessionConfiguration | Enable-PSSessionConfiguration

描述
-----------
這些命令會重新啟用電腦上的所有工作階段設定。這些命令的作用相同，所以您可以使用任何一個命令。

如果您啟用已經啟用的工作階段設定，Enable-PSSessionConfiguration 不會產生錯誤。

範例 4

C:\PS>Enable-PSSessionConfiguration -name MaintenanceShell -securityDescriptorSDDL "O:NSG:BAD:P(A;;GXGWGR;;;BA)(A;;GAGR;;;S-1-5-21-123456789-188441444-3100496)S:P"

描述
-----------
這個命令會重新啟用 MaintenanceShell 工作階段設定並針對此設定指定新的安全性描述元。

請參閱

概念

about_Session_Configurations
Disable-PSSessionConfiguration
Get-PSSessionConfiguration
Register-PSSessionConfiguration
Set-PSSessionConfiguration
Unregister-PSSessionConfiguration
WSMan Provider

共用方式為