Stop-DscConfiguration
Hiermee stopt u een configuratietaak die wordt uitgevoerd.
Syntaxis
All
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.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | 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.
Parametereigenschappen
| Type: | |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Sessie |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | 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.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Cf |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Force
Hiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | 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.
Parametereigenschappen
| Type: | Int32 |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-WhatIf
Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Wi |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.
