Compartilhar via

Update-DscConfiguration

  • Referência
Módulo:
PSDesiredStateConfiguration

Verifica o servidor de pull para obter uma configuração atualizada e a aplica.

Syntax

Update-DscConfiguration
      [-Wait]
      [-JobName <String>]
      [[-ComputerName] <String[]>]
      [-Credential <PSCredential>]
      [-ThrottleLimit <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-DscConfiguration
      [-Wait]
      [-JobName <String>]
      [-ThrottleLimit <Int32>]
      -CimSession <CimSession[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O Update-DscConfiguration cmdlet se conecta a um servidor de pull, baixa a configuração se ela difere do que é atual no nó e aplica a configuração ao computador.

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: Atualizar uma configuração

Update-DscConfiguration -Wait -Verbose

Depois de executar esse comando, o servidor se conectará ao serviço de pull registrado, baixará a configuração atribuída mais recente e a aplicará. Os parâmetros Wait e Verbose são opcionais. Ao trabalhar interativamente, esses parâmetros combinados permitem comentários em tempo real sobre progresso e êxito ou falha ao aplicar a configuração.

Exemplo 2: atualizar uma configuração conectando-se em uma sessão CIM

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

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 atualiza o computador especificado no CimSession armazenado em $Session. O comando especifica o parâmetro Wait . O console não aceita comandos adicionais até que o comando atual seja concluído.

Parâmetros

-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 . O padrão é a sessão atual do computador local.

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

-ComputerName

Especifica uma matriz de nomes de computador. O cmdlet aplica as configurações aos computadores especificados por esse parâmetro.

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Required:False
Accept pipeline input:True
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

-Credential

Especifica um nome de usuário e uma senha, como um objeto PSCredential, para o computador de destino. Para obter um objeto PSCredential , use o Get-Credential cmdlet . Para obter mais informações, digite Get-Help Get-Credential.

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

-JobName

Especifica um nome amigável para um trabalho. Se você especificar esse parâmetro, o cmdlet será executado como um trabalho e retorna um objeto Job.

Por padrão, Windows PowerShell atribui o nome JobN em que N é um inteiro.

Se você especificar o parâmetro Wait, não especifique esse parâmetro.

Type:String
Position:Named
Default value:None
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. Se esse parâmetro for omitido ou um valor de 0 for inserido, Windows PowerShell calculará um limite de limitação ideal para o cmdlet com base no número de cmdlets CIM em execução no computador. O limite de aceleração aplica-se somente ao cmdlet atual, e não à sessão ou ao computador.

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

-Wait

Indica que o cmdlet bloqueia o console até concluir todas as tarefas de configuração.

Se você especificar esse parâmetro, não especifique o parâmetro JobName.

Type:SwitchParameter
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