Compartilhar via

Restore-DscConfiguration

  • Referência
Módulo:
PSDesiredStateConfiguration

Reaplica a configuração anterior para o nó.

Syntax

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

Description

O Restore-DscConfiguration cmdlet reaplica a configuração anterior para o nó, se houver uma configuração anterior. Especifique computadores usando sessões CIM (Common Information Model). Se você não especificar um computador de destino, o cmdlet restaurará a configuração do computador local. Se não houver nenhuma configuração anterior para um nó específico, esse cmdlet retornará uma mensagem de erro.

Esse cmdlet não dá suporte ao parâmetro Confirm .

Exemplos

Exemplo 1: Restaurar a configuração do computador local

Restore-DscConfiguration

Este comando restaura a configuração do computador local.

Exemplo 2: restaurar a configuração de um computador especificado

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Restore-DscConfiguration -CimSession $Session

Este exemplo restaura a configuração em um computador especificado por uma sessão CIM. O exemplo cria uma sessão CIM para um computador denominado Server01 para uso com o cmdlet. Como alternativa, crie uma matriz de sessões CIM para aplicar o cmdlet a vários computadores especificados.

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

O segundo comando restaura a configuração dos computadores identificados pelos objetos CimSession armazenados na $Session variável, nesse caso, o computador chamado Server01.

Parâmetros

-AsJob

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 New-CimSession cmdlet ou Get-CimSession .

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

-Confirm

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

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

-ThrottleLimit

Especifica o número máximo de operações simultâneas que podem ser estabelecidas para executar o cmdlet.

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

-WhatIf

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

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