Dela via

Remove-DscConfigurationDocument

  • Referens
Modul:
PSDesiredStateConfiguration

Tar bort ett konfigurationsdokument från DSC-konfigurationsarkivet.

Syntax

Remove-DscConfigurationDocument
      -Stage <Stage>
      [-Force]
      [-CimSession <CimSession[]>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Cmdleten Remove-DscConfigurationDocument tar bort ett konfigurationsdokument (.mof fil) från konfigurationsarkivet för Windows PowerShell Desired State Configuration (DSC). Under konfigurationen kopierar cmdleten Start-DscConfiguration en .mof fil till en mapp på måldatorn. Den här cmdleten tar bort konfigurationsdokumentet och gör ytterligare rensning.

Den här cmdleten är endast tillgänglig som en del av den samlade uppdateringen november 2014 för Windows RT 8.1, Windows 8.1 och Windows Server 2012 R2.

Exempel

Exempel 1: Ta bort det aktuella konfigurationsdokumentet

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Remove-DscConfigurationDocument -Stage Current -CimSession $Session

Det första kommandot skapar en CIM-session med hjälp av cmdleten New-CimSession och lagrar sedan objektet CimSession i variabeln $Session. Kommandot uppmanar dig att ange ett lösenord. Om du vill ha mer information skriver du Get-Help New-CimSession.

Det andra kommandot tar bort det aktuella konfigurationsdokumentet för den dator som anges i CimSession lagras i $Session.

Parametrar

-AsJob

Anger att den här cmdleten kör kommandot som ett bakgrundsjobb.

Om du anger parametern AsJob returnerar kommandot ett objekt som representerar jobbet och visar sedan kommandotolken. Du kan fortsätta att arbeta i sessionen tills jobbet har slutförts. Jobbet skapas på den lokala datorn och resultatet från fjärrdatorerna returneras automatiskt till den lokala datorn. Om du vill hantera jobbet använder du cmdletarna Jobb. Använd cmdleten Receive-Job för att hämta jobbresultatet.

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

Mer information om Windows PowerShell-bakgrundsjobb finns i about_Jobs och about_Remote_Jobs.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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 en New-CimSession eller Get-CimSession cmdlet.

Typ:CimSession[]
Alias:Session
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Force

Anger att den här cmdleten stoppar konfigurationsjobbet som körs innan konfigurationsdokumentet raderas. Tvingar kommandot att köras utan att be om användarbekräftelse.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Stage

Anger vilket konfigurationsdokument som ska tas bort. Du kan ange flera dokument. De godtagbara värdena för den här parametern är:

  • Current – Ta bort konfigurationsdokumentet som beskriver systemets aktuella tillstånd.
  • Pending – Ta bort konfigurationsdokumentet som beskriver systemets väntande tillstånd.
  • Previous – Ta bort konfigurationsdokumentet som beskriver systemets tidigare tillstånd.
Typ:Microsoft.PowerShell.Cmdletization.GeneratedTypes.RemoveDscConfigurationDocument.Stage
Godkända värden:Current, Pending, Previous
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken: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 på 0 anges beräknar Windows PowerShell en optimal begränsningsgräns för cmdleten 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 på datorn.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

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

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

None

Utdata

None