Remove-DscConfigurationDocument

  • Riferimento
Modulo:
PSDesiredStateConfiguration

Rimuove un documento di configurazione dall'archivio di configurazione DSC.

Sintassi

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

Descrizione

Il Remove-DscConfigurationDocument cmdlet rimuove un documento di configurazione (.moffile) dall'archivio di configurazione Windows PowerShell Desired State Configuration (DSC). Durante la configurazione, il Start-DscConfiguration cmdlet copia un .mof file in una cartella nel computer di destinazione. Questo cmdlet rimuove tale documento di configurazione ed esegue una pulizia aggiuntiva.

Questo cmdlet è disponibile solo come parte dell'aggiornamento cumulativo di novembre 2014 per Windows RT 8.1, Windows 8.1 e Windows Server 2012 R2.

Esempio

Esempio 1: Rimuovere il documento di configurazione corrente

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

Il primo comando crea una sessione CIM usando il New-CimSession cmdlet e quindi archivia l'oggetto CimSession nella variabile $Session. Il comando richiede l'immissione di una password. Per ulteriori informazioni, digitare Get-Help New-CimSession.

Il secondo comando rimuove il documento di configurazione corrente per il computer specificato in CimSession archiviato in $Session.

Parametri

-AsJob

Indica che questo cmdlet esegue il comando come processo in background.

Se si specifica il parametro AsJob , il comando restituisce un oggetto che rappresenta il processo e quindi visualizza il prompt dei comandi. È possibile continuare a lavorare nella sessione fino al termine del processo. Il processo viene creato nel computer locale e i risultati del computer remoto vengono automaticamente restituiti al computer locale. Per gestire il processo, utilizzare i cmdlet Job. Per ottenere i risultati del processo, usare il Receive-Job cmdlet.

Per usare questo parametro, i computer locali e remoti devono essere configurati per la comunicazione remota e in Windows Vista e versioni successive del sistema operativo Windows, è necessario aprire Windows PowerShell con l'opzione Esegui come amministratore. Per altre informazioni, vedere about_Remote_Requirements.

Per altre informazioni sui processi in background Windows PowerShell, vedere about_Jobs e about_Remote_Jobs.

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

-CimSession

Esegue il cmdlet in una sessione remota o in un computer remoto. Immettere un nome computer o un oggetto sessione, ad esempio l'output di un New-CimSession cmdlet o Get-CimSession .

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

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

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

-Force

Indica che questo cmdlet arresta il processo di configurazione in esecuzione prima di rimuovere il documento di configurazione. Forza l'esecuzione del comando senza chiedere conferma all'utente.

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

-Stage

Specifica il documento di configurazione da rimuovere. È possibile specificare più documenti. I valori validi per questo parametro sono:

  • Current - Rimuovere il documento di configurazione che descrive lo stato corrente del sistema.
  • Pending - Rimuovere il documento di configurazione che descrive lo stato in sospeso del sistema.
  • Previous - Rimuovere il documento di configurazione che descrive lo stato precedente del sistema.
Type:Microsoft.PowerShell.Cmdletization.GeneratedTypes.RemoveDscConfigurationDocument.Stage
Accepted values:Current, Pending, Previous
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ThrottleLimit

Specifica il numero massimo di operazioni simultanee che è possibile stabilire per eseguire il cmdlet. Se questo parametro viene omesso o viene immesso un valore di 0 , Windows PowerShell calcola un limite ottimale per il cmdlet in base al numero di cmdlet in esecuzione nel computer. Questo valore limite su applica solo al cmdlet corrente, non alla sessione o al computer.

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

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Input

None

Output

None