Restore-DscConfiguration
Reaplica a configuração anterior para o nó.
Sintaxe
Restore-DscConfiguration
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Restore-DscConfiguration
reaplica a configuração anterior para o nó, se existir 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.
Este cmdlet não oferece 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 chamado 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 cmdlet New-CimSession
e, em seguida, 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 restaura a configuração para os computadores identificados pelo CimSession objetos armazenados na variável $Session
, neste caso, o computador chamado Server01.
Parâmetros
-AsJob
Indica que esse cmdlet executa o comando como um trabalho em segundo plano.
Tipo: | SwitchParameter |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | 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 |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-Confirm
Solicita confirmação antes de executar o cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-ThrottleLimit
Especifica o número máximo de operações simultâneas que podem ser estabelecidas para executar o cmdlet.
Tipo: | Int32 |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |