Condividi tramite

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 cmdlet Remove-DscConfigurationDocument rimuove un documento di configurazione (.mof file) dall'archivio di configurazione DSC (Desired State Configuration) di Windows PowerShell. Durante la configurazione, il cmdlet Start-DscConfiguration copia un file .mof in una cartella nel computer di destinazione. Questo cmdlet rimuove il documento di configurazione ed esegue operazioni di pulizia aggiuntive.

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 cmdlet New-CimSession e quindi archivia l'oggetto CimSession nella variabile $Session. Il comando richiede una password. Per altre informazioni, digitare Get-Help New-CimSession.

Il secondo comando rimuove il documento di configurazione corrente per il computer specificato nella 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 dei computer remoti vengono restituiti automaticamente al computer locale. Per gestire il processo, usare i cmdlet job. Per ottenere i risultati del processo, usare il cmdlet Receive-Job.

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 di Windows PowerShell, vedere about_Jobs e about_Remote_Jobs.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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 cmdlet New-CimSession o Get-CimSession.

Tipo:CimSession[]
Alias:Session
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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 dell'utente.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Stage

Specifica il documento di configurazione da rimuovere. È possibile specificare più documenti. I valori accettabili 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.
Tipo:Microsoft.PowerShell.Cmdletization.GeneratedTypes.RemoveDscConfigurationDocument.Stage
Valori accettati:Current, Pending, Previous
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly: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 di limitazione ottimale per il cmdlet in base al numero di cmdlet CIM in esecuzione nel computer. Il limite di limitazione si applica solo al cmdlet corrente, non alla sessione o al computer.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

None