Condividi tramite

Update-DscConfiguration

Modulo:
PSDesiredStateConfiguration Module v1.1

Controlla il server di pull per una configurazione aggiornata e la applica.

Sintassi

ComputerNameSet (impostazione predefinita). 

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

CimSessionSet 

Update-DscConfiguration
    -CimSession <CimSession[]>
    [-Wait]
    [-JobName <String>]
    [-ThrottleLimit <Int32>]
    [-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.

Proprietà dei parametri

Tipo:

CimSession[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

CimSessionSet
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ComputerName

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

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Cina, Nome del Server

Set di parametri

ComputerNameSet
Posizione:1
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:PSCredential
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ComputerNameSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:Int32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.