Stop-DscConfiguration
Hiermee stopt u een configuratietaak die wordt uitgevoerd.
Syntaxis
Stop-DscConfiguration
[-Force]
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
De Stop-DscConfiguration cmdlet stopt een configuratietaak die wordt uitgevoerd. Geef op op welke computers deze cmdlet van toepassing is met behulp van CIM-sessies (Common Information Model). Als er geen configuratietaak wordt uitgevoerd, retourneert deze cmdlet een waarschuwingsbericht.
Stop-DscConfiguration is alleen beschikbaar als onderdeel van het updatepakket van november 2014 voor Windows RT 8.1, Windows 8.1 en Windows Server 2012 R2 uit de Microsoft-ondersteuningsbibliotheek. Voordat u deze cmdlet gebruikt, raadpleegt u de informatie in Wat is er nieuw in Windows PowerShell 5.0
Voorbeelden
Voorbeeld 1: Een configuratietaak stoppen
In dit voorbeeld wordt een CIM-sessie gemaakt met behulp van de cmdlet New-CimSession. Het CimSession--object wordt gebruikt om een actieve configuratietaak te stoppen.
$Session = New-CimSession -ComputerName Server01 -Credential ACCOUNTS\User01
Stop-DscConfiguration -CimSession $Session
New-CimSession gebruikt de parameter ComputerName om de Server01-computer op te geven. De parameter Credential specificeert het gebruikersaccount. Het CimSession--object wordt opgeslagen in de variabele $Session. Wanneer de opdracht wordt uitgevoerd, wordt u gevraagd om het wachtwoord van het gebruikersaccount.
Stop-DscConfiguration gebruikt de parameter CimSession en het object dat is opgeslagen in $Session om de configuratietaak te stoppen.
Parameters
-AsJob
Geeft aan dat met deze cmdlet de opdracht wordt uitgevoerd als achtergrondtaak. Zie about_Jobs en about_Remote_Jobsvoor meer informatie over PowerShell-achtergrondtaken.
Als u de parameter AsJob wilt gebruiken, moeten de lokale en externe computers worden geconfigureerd voor externe communicatie. In Windows Vista en latere versies van het Windows-besturingssysteem moet u PowerShell openen met de optie Als administrator uitvoeren. Zie about_Remote_Requirementsvoor meer informatie.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-CimSession
De cmdlet wordt uitgevoerd in een externe sessie of op een externe computer. Voer een computernaam of een sessieobject in, zoals de uitvoer van New-CimSession of Get-CimSession.
| Type: | CimSession[] |
| Aliassen: | Session |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-Confirm
Stop-DscConfiguration biedt geen ondersteuning voor de parameter Bevestigen. Als de parameter Bevestigen wordt gebruikt, wordt er een fout weergegeven.
Voor PowerShell-cmdlets die ondersteuning bieden voor Bevestigen, vraagt u met de parameter u om verificatie voordat een opdracht wordt uitgevoerd.
| Type: | SwitchParameter |
| Aliassen: | cf |
| Position: | Named |
| Default value: | False |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-Force
Hiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-ThrottleLimit
Hiermee geeft u het maximum aantal gelijktijdige bewerkingen op dat kan worden ingesteld om de cmdlet uit te voeren.
Als deze parameter wordt weggelaten of als er een waarde van 0 wordt ingevoerd, berekent PowerShell een optimale beperkingslimiet op basis van het aantal CIM-cmdlets dat op de computer wordt uitgevoerd. De beperkingslimiet is alleen van toepassing op de huidige cmdlet, niet op de sessie of op de computer.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-WhatIf
Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.
| Type: | SwitchParameter |
| Aliassen: | wi |
| Position: | Named |
| Default value: | False |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
Invoerwaarden
None
Uitvoerwaarden
None
