Condividi tramite

Update-DscConfiguration

  • Riferimento
Modulo:
PSDesiredStateConfiguration

Controlla il server di pull per una configurazione aggiornata e la 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 cmdlet Update-DscConfiguration si connette a un server di 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, scaricherà la configurazione assegnata più recente e quindi la applicherà. I parametri Wait e Verbose sono facoltativi. Quando si lavora in modo interattivo, questi parametri combinati consentono il feedback in tempo reale sullo stato di avanzamento e sull'esito positivo o negativo durante l'applicazione della configurazione.

Esempio 2: Aggiornare una configurazione connettendosi tramite 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 New-CimSession e quindi archivia l'oggetto CimSession nella variabile $Session. Il comando richiede una password. Per altre informazioni, digitare Get-Help New-CimSession.

Il secondo comando aggiorna il computer specificato nella 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 New-CimSession o cmdlet Get-CimSession. Il valore predefinito è la sessione corrente nel computer locale.

Tipo:CimSession[]
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ComputerName

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

Tipo:String[]
Alias:CN, ServerName
Posizione:1
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Credential

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

Tipo:PSCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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 dove N è un numero intero.

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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 di limitazione ottimale per il cmdlet in base al numero di cmdlet CIM in esecuzione nel computer. Il limite di limitazione si applica solo al cmdlet corrente, non alla sessione o al computer.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False