共用方式為


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_Jobsabout_Remote_Jobs

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

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

-CimSession

在遠端會話或遠端電腦上執行 Cmdlet。 輸入計算機名稱或會話物件,例如來自 New-CimSessionGet-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