Stop-DscConfiguration

  • Referentie
Module:
PSDesiredStateConfiguration

Hiermee stopt u een actieve configuratietaak.

Syntax

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-DscConfigurationis 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 Ondersteuning-bibliotheek. 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 New-CimSession cmdlet. 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. Met de parameter Credential wordt het gebruikersaccount opgegeven. Het CimSession-object wordt opgeslagen in de $Session variabele. 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 deze cmdlet de opdracht als een achtergrondtaak uitvoert. Zie about_Jobs en about_Remote_Jobs voor 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_Requirements voor meer informatie.

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

-CimSession

Voert de cmdlet uit 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[]
Aliases:Session
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Stop-DscConfiguration biedt geen ondersteuning voor de parameter Confirm . Als de parameter Confirm wordt gebruikt, wordt er een fout weergegeven.

Voor PowerShell-cmdlets die ondersteuning bieden voor Bevestigen, vraagt u om verificatie met behulp van de parameter voordat een opdracht wordt uitgevoerd.

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

-Force

Hiermee dwingt u de opdracht uit te voeren zonder om bevestiging van de gebruiker te vragen.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

Invoerwaarden

None

Uitvoerwaarden

None