Stop-DscConfiguration
停止正在執行的組態作業。
語法
All
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
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-CimSession
在遠端會話或遠端電腦上執行 Cmdlet。 輸入計算機名稱或會話物件，例如來自 New-CimSession 或 Get-CimSession的輸出。
參數屬性
| 類型: | |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 會期 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
Stop-DscConfiguration 不支援 Confirm 參數。 如果使用 Confirm 參數，則會顯示錯誤。
針對支援 確認的 PowerShell Cmdlet，使用 參數會在命令執行之前提示您進行驗證。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | cf |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Force
強制命令執行，而不要求使用者確認。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ThrottleLimit
指定可以建立以執行 Cmdlet 的並行作業數目上限。
如果省略此參數或輸入 0 的值，PowerShell 會根據計算機上執行的 CIM Cmdlet 數目計算最佳節流限制。 節流限制僅適用於目前的 Cmdlet，不適用於工作階段或電腦。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 該 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。
