Partilhar via

Update-DscConfiguration

  • Referência
Módulo:
PSDesiredStateConfiguration

Verifica se o servidor de extração tem uma configuração atualizada e aplica-a.

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 liga-se a um servidor de extração, transfere a configuração se for diferente do que é atual no nó e, em seguida, aplica a configuração ao computador.

Este cmdlet só está disponível como parte do update rollup 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 este comando, o servidor irá ligar ao serviço pull registado, transferir a configuração atribuída mais recente e, em seguida, aplicá-la. Os parâmetros Wait e Verbose são opcionais. Ao trabalhar interativamente, estes parâmetros combinados permitem feedback em tempo real sobre o progresso e o sucesso ou a falha ao aplicar a configuração.

Exemplo 2: atualizar uma configuração ao ligar 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 com o New-CimSession cmdlet e, em seguida, armazena o objeto CimSession na $Session variável . O comando pede-lhe uma palavra-passe. Para mais informações, insira Get-Help New-CimSession.

O segundo comando atualiza o computador especificado na CimSession armazenada no $Session. O comando especifica o parâmetro Aguardar . A consola não aceita comandos adicionais até que o comando atual seja concluído.

Parâmetros

-CimSession

Executa o cmdlet numa sessão remota ou num computador remoto. Introduza um nome de computador ou um objeto de sessão, como a saída de um cmdlet New-CimSession ou Get-CimSession . A predefinição é a sessão atual no 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 computadores. O cmdlet aplica as definições de configuração aos computadores especificados por este parâmetro.

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Solicita a 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 utilizador e palavra-passe, como um objeto PSCredential , para o computador de destino. Para obter um objeto PSCredential , utilize o Get-Credential cmdlet . Para mais informações, insira 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 uma tarefa. Se especificar este parâmetro, o cmdlet é executado como uma tarefa e devolve um objeto Job .

Por predefinição, Windows PowerShell atribui o nome JobN em que N é um número inteiro.

Se especificar o parâmetro Aguardar , não especifique este 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 este parâmetro for omitido ou for introduzido um valor de0, Windows PowerShell calcula um limite de limitação ideal para o cmdlet com base no número de cmdlets CIM que estão em execução no computador. O limite de limitação aplica-se apenas ao cmdlet atual, 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 a consola até concluir todas as tarefas de configuração.

Se especificar este 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

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

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