Stop-DscConfiguration

參考

模組:: PSDesiredStateConfiguration

停止正在執行的組態作業。

語法

Stop-DscConfiguration
    [-Force]
    [-CimSession <CimSession[]>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Stop-DscConfiguration Cmdlet 會停止執行中的設定作業。指定此 Cmdlet 使用 Common Information Model （CIM）工作階段所套用的電腦。如果沒有執行任何組態作業，此 Cmdlet 會傳回警告訊息。

Stop-DscConfiguration 僅適用於 2014 年 11 月 Windows RT 8.1、Windows 8.1 和 Windows Server 2012 R 2 更新匯總的一部分，Microsoft支持連結庫。使用此 Cmdlet 之前，請先檢閱 Windows PowerShell 5.0 的新功能資訊

範例

範例 1：停止設定作業

在此範例中，會使用 New-CimSession Cmdlet 建立 CIM 會話。 CimSession 物件可用來停止執行中的組態作業。

$Session = New-CimSession -ComputerName Server01 -Credential ACCOUNTS\User01
Stop-DscConfiguration -CimSession $Session

New-CimSession 會使用 ComputerName 參數來指定 Server01 計算機。 Credential 參數會指定用戶帳戶。 CimSession 物件會儲存在 $Session 變數中。當命令執行時，系統會提示您輸入使用者帳戶的密碼。

Stop-DscConfiguration 會使用 CimSession 參數和儲存在 $Session 中的物件來停止設定作業。

參數

-AsJob

表示此 Cmdlet 會以背景工作的形式執行命令。如需 PowerShell 背景工作的詳細資訊，請參閱 about_Jobs 和 about_Remote_Jobs。

若要使用 AsJob 參數，必須設定本機和遠端電腦來進行遠端處理。在 Windows Vista 和更新版本的 Windows作系統上，您必須使用 [以 系統管理員身分執行] 選項來開啟 PowerShell。如需詳細資訊，請參閱 about_Remote_Requirements。

類型:	SwitchParameter
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CimSession

在遠端會話或遠端電腦上執行 Cmdlet。輸入計算機名稱或會話物件，例如來自 New-CimSession 或 Get-CimSession的輸出。

類型:	CimSession[]
別名:	Session
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

Stop-DscConfiguration 不支援 Confirm 參數。如果使用 Confirm 參數，則會顯示錯誤。

針對支援確認的 PowerShell Cmdlet，使用參數會在命令執行之前提示您進行驗證。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Force

強制命令執行，而不要求使用者確認。

類型:	SwitchParameter
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ThrottleLimit

指定可以建立以執行 Cmdlet 的並行作業數目上限。

如果省略此參數或輸入 0 的值，PowerShell 會根據計算機上執行的 CIM Cmdlet 數目計算最佳節流限制。節流限制僅適用於目前的 Cmdlet，不適用於工作階段或電腦。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

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

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

None

輸出