Stop-DscConfiguration
停止正在執行的組態作業。
語法
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
輸出
None