Update-DscConfiguration

  • Riferimento
Modulo:
PSDesiredStateConfiguration

Controlla il server pull per una configurazione aggiornata e lo applica.

Sintassi

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>]

Descrizione

Il Update-DscConfiguration cmdlet si connette a un server pull, scarica la configurazione se è diversa da quella corrente nel nodo e quindi applica la configurazione al computer.

Questo cmdlet è disponibile solo come parte dell'aggiornamento cumulativo di novembre 2014 per Windows RT 8.1, Windows 8.1 e Windows Server 2012 R2.

Esempio

Esempio 1: Aggiornare una configurazione

Update-DscConfiguration -Wait -Verbose

Dopo aver eseguito questo comando, il server si connetterà al servizio pull registrato, scaricare la configurazione assegnata più recente e quindi applicarla. I parametri Wait e Verbose sono facoltativi. Quando si lavora in modo interattivo, questi parametri combinano feedback in tempo reale sull'avanzamento e sull'esito positivo o negativo durante l'applicazione della configurazione.

Esempio 2: Aggiornare una configurazione connettendosi a una sessione CIM

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

Il primo comando crea una sessione CIM usando il cmdlet e quindi archivia l'oggetto New-CimSessionCimSession nella $Session variabile. Il comando richiede l'immissione di una password. Per ulteriori informazioni, digitare Get-Help New-CimSession.

Il secondo comando aggiorna il computer specificato in CimSession archiviato in $Session. Il comando specifica il parametro Wait . La console non accetta comandi aggiuntivi fino al termine del comando corrente.

Parametri

-CimSession

Esegue il cmdlet in una sessione remota o in un computer remoto. Immettere un nome computer o un oggetto sessione, ad esempio l'output di un cmdlet New-CimSession o Get-CimSession. Il valore predefinito è la sessione corrente nel computer locale.

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

-ComputerName

Specifica una matrice di nomi di computer. Il cmdlet applica le impostazioni di configurazione ai computer specificati da questo parametro.

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

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

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

-Credential

Specifica un nome utente e una password, come un oggetto PSCredential, per il computer di destinazione. Per ottenere un oggetto PSCredential , usare il Get-Credential cmdlet. Per ulteriori informazioni, digitare Get-Help Get-Credential.

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

-JobName

Specifica un nome descrittivo per un processo. Se si specifica questo parametro, il cmdlet viene eseguito come processo e restituisce un oggetto Job.

Per impostazione predefinita, Windows PowerShell assegna il nome JobN in cui N è un numero intero.

Se si specifica il parametro Wait, non specificare questo parametro.

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

-ThrottleLimit

Specifica il numero massimo di operazioni simultanee che è possibile stabilire per eseguire il cmdlet. Se questo parametro viene omesso o viene immesso un valore di 0 , Windows PowerShell calcola un limite ottimale per il cmdlet in base al numero di cmdlet in esecuzione nel computer. Questo valore limite su applica solo al cmdlet corrente, non alla sessione o al computer.

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

-Wait

Indica che il cmdlet blocca la console fino al termine di tutte le attività di configurazione.

Se si specifica questo parametro, non specificare il parametro JobName.

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

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

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