Partilhar via

Update-DscConfiguration

  • Referência
Módulo:
PSDesiredStateConfiguration

Verifica se há uma configuração atualizada no servidor pull e a aplica.

Sintaxe

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 cmdlet Update-DscConfiguration se conecta a um servidor pull, baixa a configuração se ela for diferente da atual no nó e, em seguida, aplica a configuração ao computador.

Este cmdlet está disponível apenas como parte do pacote cumulativo de atualizações de novembro de 2014 do 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 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 feedback em tempo real sobre o progresso e o sucesso ou falha ao aplicar a configuração.

Exemplo 2: Atualizar uma configuração conectando-se através de 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 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 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 New-CimSession ou cmdlet Get-CimSession. O padrão é a sessão atual no computador local.

Tipo:CimSession[]
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ComputerName

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

Tipo:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
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

-Credential

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

Tipo:PSCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-JobName

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

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

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

Tipo:String
Position:Named
Default value:None
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. Se esse parâmetro for omitido ou um valor de 0 for inserido, o Windows PowerShell calculará um limite de aceleraçã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 apenas ao cmdlet atual, não à sessão ou ao computador.

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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.

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