Stop-DscConfiguration

  • Referens
Modul:
PSDesiredStateConfiguration

Stoppar ett konfigurationsjobb som körs.

Syntax

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

Description

Cmdleten Stop-DscConfiguration stoppar ett konfigurationsjobb som körs. Ange vilka datorer denna cmdlet gäller för med hjälp av CIM-sessioner (Common Information Model). Om inget konfigurationsjobb körs returnerar den här cmdleten ett varningsmeddelande.

Stop-DscConfigurationär endast tillgängligt som en del av samlad uppdatering från november 2014 för Windows RT 8.1, Windows 8.1 och Windows Server 2012 R2 från Microsoft Support-biblioteket. Innan du använder den här cmdleten granskar du informationen i Nyheter i Windows PowerShell 5.0

Exempel

Exempel 1: Stoppa ett konfigurationsjobb

I det här exemplet skapas en CIM-session med cmdleten New-CimSession . CimSession-objektet används för att stoppa ett pågående konfigurationsjobb.

$Session = New-CimSession -ComputerName Server01 -Credential ACCOUNTS\User01
Stop-DscConfiguration -CimSession $Session

New-CimSession använder parametern ComputerName för att ange Server01-datorn. Parametern Credential anger användarkontot. CimSession-objektet lagras i variabeln $Session . När kommandot körs uppmanas du att ange användarkontots lösenord.

Stop-DscConfiguration använder parametern CimSession och objektet som lagras i $Session för att stoppa konfigurationsjobbet.

Parametrar

-AsJob

Anger att denna cmdlet kör kommandot som ett bakgrundsjobb. Mer information om PowerShell-bakgrundsjobb finns i about_Jobs och about_Remote_Jobs.

Om du vill använda asjob-parametern måste de lokala datorerna och fjärrdatorerna konfigureras för fjärrkommunikation. I Windows Vista och senare versioner av Windows-operativsystemet måste du öppna PowerShell med alternativet Kör som administratör . Mer information finns i about_Remote_Requirements.

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

-CimSession

Kör cmdleten i en fjärrsession eller på en fjärrdator. Ange ett datornamn eller ett sessionsobjekt, till exempel utdata från New-CimSession eller Get-CimSession.

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

-Confirm

Stop-DscConfiguration stöder inte parametern Confirm . Om parametern Confirm (Bekräfta ) används visas ett fel.

För PowerShell-cmdletar som stöder Bekräfta uppmanas du att verifiera med hjälp av parametern innan ett kommando körs.

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

-Force

Tvingar kommandot att köras utan att be om användarbekräftelse.

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

-ThrottleLimit

Anger det maximala antalet samtidiga åtgärder som kan upprättas för att köra cmdleten.

Om den här parametern utelämnas eller ett värde för 0 anges beräknar PowerShell en optimal begränsningsgräns baserat på antalet CIM-cmdletar som körs på datorn. Begränsningsgränsen gäller endast för den aktuella cmdleten, inte för sessionen eller datorn.

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

Indata

None

Utdata

None