Stop-DscConfiguration

  • 參考
模組:
PSDesiredStateConfiguration

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

Syntax

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

Description

Cmdlet 會 Stop-DscConfiguration 停止正在執行的組態作業。 使用通用訊息模型 (CIM) 工作階段，來指定要將此 Cmdlet 套用至哪些電腦。 如果沒有執行中的設定作業，此 Cmdlet 會傳回警告訊息。

Stop-DscConfiguration僅適用于2014 年 11 月更新彙總套件的一部分，Windows RT 8.1、Windows 8.1，以及從 Microsoft 支援服務 程式庫Windows Server 2012 R2。 使用此 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。

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CimSession

在遠端工作階段或遠端電腦上執行 Cmdlet。 輸入電腦名稱稱或會話物件，例如 或 Get-CimSession 的 New-CimSession 輸出。

Type:CimSession[]
Aliases:Session
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ThrottleLimit

指定為執行 Cmdlet 可建立的最大並行作業數。

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 不會執行此 Cmdlet。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

None

輸出

None