Stop-DscConfiguration

  • Referenz
Modul:
PSDesiredStateConfiguration

Beendet einen ausgeführten Konfigurationsauftrag.

Syntax

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

Beschreibung

Das Stop-DscConfiguration Cmdlet beendet einen ausgeführten Konfigurationsauftrag. Geben Sie mithilfe von CIM-Sitzungen (Common Information Model) an, auf welche Computer dieses Cmdlet angewendet wird. Wenn kein Konfigurationsauftrag ausgeführt wird, gibt dieses Cmdlet eine Warnmeldung zurück.

Stop-DscConfigurationist nur im Rahmen des Updaterollups vom November 2014 für Windows RT 8.1, Windows 8.1 und Windows Server 2012 R2 aus der Microsoft-Support-Bibliothek verfügbar. Bevor Sie dieses Cmdlet verwenden, lesen Sie die Informationen unter Neuigkeiten in Windows PowerShell 5.0.

Beispiele

Beispiel 1: Beenden eines Konfigurationsauftrags

In diesem Beispiel wird mithilfe des New-CimSession Cmdlets 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 ComputerName-Parameter , um den Server01-Computer anzugeben. Der Parameter Credential gibt das Benutzerkonto an. Das CimSession-Objekt wird in der $Session Variablen gespeichert. Wenn der Befehl ausgeführt wird, werden Sie zur Eingabe des Kennworts des Benutzerkontos aufgefordert.

Stop-DscConfiguration verwendet den CimSession-Parameter 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 AsJob-Parameter verwenden zu können, müssen die lokalen Computer und die 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.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 von New-CimSession oder Get-CimSession.

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

-Confirm

Stop-DscConfiguration unterstützt den Confirm-Parameter nicht. Wenn der Confirm-Parameter verwendet wird, wird ein Fehler angezeigt.

Für PowerShell-Cmdlets, die Confirm unterstützen, werden Sie mithilfe des Parameters zur Überprüfung aufgefordert, bevor ein Befehl ausgeführt wird.

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

-Force

Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.

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

-ThrottleLimit

Gibt die maximale Anzahl von gleichzeitigen Vorgängen an, die zum Ausführen des Cmdlets erstellt werden können.

Wenn dieser Parameter ausgelassen oder ein Wert von 0 eingegeben wird, berechnet PowerShell ein optimales Drosselungslimit basierend auf der Anzahl der CIM-Cmdlets, die auf dem Computer ausgeführt werden. Dieser Drosselungsgrenzwert gilt nur für das aktuelle Cmdlet, nicht für die Sitzung oder den PC.

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Eingaben

None

Ausgaben

None