Compartilhar via

Remove-DscConfigurationDocument

  • Referência
Módulo:
PSDesiredStateConfiguration

Remove um documento de configuração do repositório de configuração do DSC.

Sintaxe

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

Description

O cmdlet Remove-DscConfigurationDocument remove um documento de configuração (.mof arquivo) do repositório de configuração DSC (Configuração de Estado Desejado) do Windows PowerShell. Durante a configuração, o cmdlet Start-DscConfiguration copia um arquivo .mof para uma pasta no computador de destino. Esse cmdlet remove esse documento de configuração e faz limpeza adicional.

Esse cmdlet está disponível apenas como parte do pacote cumulativo de atualizações de novembro de 2014 para Windows RT 8.1, Windows 8.1 e Windows Server 2012 R2.

Exemplos

Exemplo 1: remover o documento de configuração atual

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

O primeiro comando cria uma sessão CIM usando o cmdlet New-CimSession e armazena o objeto CimSession na variável $Session. O comando solicita uma senha. Para obter mais informações, digite Get-Help New-CimSession.

O segundo comando remove o documento de configuração atual do computador especificado no CimSession armazenado em $Session.

Parâmetros

-AsJob

Indica que esse cmdlet executa o comando como um trabalho em segundo plano.

Se você especificar o parâmetro AsJob, o comando retornará um objeto que representa o trabalho e exibirá o prompt de comando. Você pode continuar a trabalhar na sessão até que o trabalho seja concluído. O trabalho é criado no computador local e os resultados de computadores remotos são retornados automaticamente para o computador local. Para gerenciar o trabalho, use os cmdlets de trabalho. Para obter os resultados do trabalho, use o cmdlet Receive-Job.

Para usar esse parâmetro, os computadores locais e remotos devem ser configurados para comunicação remota e, no Windows Vista e versões posteriores do sistema operacional Windows, você deve abrir o Windows PowerShell com a opção Executar como administrador. Para obter mais informações, consulte about_Remote_Requirements.

Para obter mais informações sobre trabalhos em segundo plano do Windows PowerShell, consulte about_Jobs e about_Remote_Jobs.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CimSession

Executa o cmdlet em uma sessão remota ou em um computador remoto. Insira um nome de computador ou um objeto de sessão, como a saída de um cmdlet New-CimSession ou Get-CimSession.

Tipo:CimSession[]
Aliases:Session
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

Indica que esse cmdlet interrompe o trabalho de configuração em execução antes de remover o documento de configuração. Força o comando a ser executado sem solicitar a confirmação do usuário.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Stage

Especifica qual documento de configuração remover. Você pode especificar vários documentos. Os valores aceitáveis para este parâmetro são:

  • Current – Remova o documento de configuração que descreve o estado atual do sistema.
  • Pending – remova o documento de configuração que descreve o estado pendente do sistema.
  • Previous – remova o documento de configuração que descreve o estado anterior do sistema.
Tipo:Microsoft.PowerShell.Cmdletization.GeneratedTypes.RemoveDscConfigurationDocument.Stage
Valores aceitos:Current, Pending, Previous
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ThrottleLimit

Especifica o número máximo de operações simultâneas que podem ser estabelecidas para executar o cmdlet. Se esse parâmetro for omitido ou um valor de 0 for inserido, o Windows PowerShell calculará um limite ideal para o cmdlet com base no número de cmdlets CIM em execução no computador. O limite de limitação se aplica somente ao cmdlet atual, não à sessão ou ao computador.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

None