Stop-DscConfiguration
Stoppt einen Konfigurationsauftrag, der ausgeführt wird.
Syntax
Stop-DscConfiguration
[-Force]
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Beschreibung
Das cmdlet Stop-DscConfiguration stoppt einen Konfigurationsauftrag, der ausgeführt wird. Geben Sie an, für welche Computer dieses Cmdlet gilt, indem Sie Common Information Model (CIM)-Sitzungen verwenden. Wenn kein Konfigurationsauftrag ausgeführt wird, gibt dieses Cmdlet eine Warnmeldung zurück.
Stop-DscConfiguration ist nur als Teil des November 2014-Updaterollups für Windows RT 8.1, Windows 8.1 und Windows Server 2012 R2 aus der Microsoft-Supportbibliothek verfügbar. Bevor Sie dieses Cmdlet verwenden, lesen Sie die Informationen in Neuigkeiten in Windows PowerShell 5.0
Beispiele
Beispiel 1: Beenden eines Konfigurationsauftrags
In diesem Beispiel wird mithilfe des cmdlets New-CimSession eine CIM-Sitzung erstellt. Das CimSession--Objekt wird verwendet, um einen ausgeführten Konfigurationsauftrag zu beenden.
$Session = New-CimSession -ComputerName Server01 -Credential ACCOUNTS\User01
Stop-DscConfiguration -CimSession $Session
New-CimSession verwendet den Parameter ComputerName, um den Server01-Computer anzugeben. Der parameter Credential gibt das Benutzerkonto an. Das CimSession--Objekt wird in der variablen $Session gespeichert. Wenn der Befehl ausgeführt wird, werden Sie aufgefordert, das Kennwort des Benutzerkontos einzugeben.
Stop-DscConfiguration verwendet den parameter CimSession und das in $Session gespeicherte Objekt, um den Konfigurationsauftrag zu beenden.
Parameter
-AsJob
Gibt an, dass dieses Cmdlet den Befehl als Hintergrundauftrag ausführt. Weitere Informationen zu PowerShell-Hintergrundaufträgen finden Sie unter about_Jobs und about_Remote_Jobs.
Um den Parameter AsJob zu verwenden, müssen die lokalen und Remotecomputer für Remoting konfiguriert werden. Unter Windows Vista und höheren Versionen des Windows-Betriebssystems müssen Sie PowerShell mit der Option "Als Administrator ausführen" öffnen. Weitere Informationen finden Sie unter about_Remote_Requirements.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CimSession
Führt das Cmdlet in einer Remotesitzung oder auf einem Remotecomputer aus. Geben Sie einen Computernamen oder ein Sitzungsobjekt ein, z. B. die Ausgabe aus New-CimSession oder Get-CimSession.
| Typ: | CimSession[] |
| Aliase: | Session |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Confirm
Stop-DscConfiguration unterstützt den Parameter Confirm nicht. Wenn die Parameter bestätigen, wird ein Fehler angezeigt.
Für PowerShell-Cmdlets, die Confirmunterstützen, werden Sie mithilfe der Parameter aufgefordert, die Überprüfung vor der Ausführung eines Befehls durchzuführen.
| Typ: | SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Force
Erzwingt die Ausführung des Befehls, ohne eine Benutzerbestätigung zu verlangen.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ThrottleLimit
Gibt die maximale Anzahl gleichzeitiger Vorgänge an, die zum Ausführen des Cmdlets eingerichtet werden können.
Wenn dieser Parameter ausgelassen wird oder ein Wert von 0 eingegeben wird, berechnet PowerShell basierend auf der Anzahl der AUF dem Computer ausgeführten CIM-Cmdlets eine optimale Drosselungsgrenze. Der Drosselungsgrenzwert gilt nur für das aktuelle Cmdlet, nicht für die Sitzung oder für den Computer.
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Typ: | SwitchParameter |
| Aliase: | wi |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
None
Ausgaben
None
