Update-DscConfiguration

  • Référence
Module:
PSDesiredStateConfiguration

Recherche une configuration mise à jour sur le serveur d’extraction et l’applique.

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

L’applet Update-DscConfiguration de commande se connecte à un serveur pull, télécharge la configuration si elle diffère de ce qui est actuel sur le nœud, puis applique la configuration à l’ordinateur.

Cette applet de commande est disponible uniquement dans le cadre du correctif cumulatif de novembre 2014 pour Windows RT 8.1, Windows 8.1 et Windows Server 2012 R2.

Exemples

Exemple 1 : Mettre à jour une configuration

Update-DscConfiguration -Wait -Verbose

Après avoir exécuté cette commande, le serveur se connecte au service d’extraction inscrit, télécharge la dernière configuration affectée, puis l’applique. Les paramètres Wait et Verbose sont facultatifs. Lorsque vous travaillez de manière interactive, ces paramètres combinés permettent des commentaires en temps réel sur la progression et la réussite ou l’échec lors de l’application de la configuration.

Exemple 2 : Mettre à jour une configuration en se connectant via une session CIM

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

La première commande crée une session CIM à l’aide de l’applet New-CimSession de commande, puis stocke l’objet CimSession dans la $Session variable. La commande vous invite à entrer un mot de passe. Pour plus d'informations, voir Get-Help New-CimSession.

La deuxième commande met à jour l’ordinateur spécifié dans cimSession stocké dans $Session. La commande spécifie le paramètre Wait . La console n’accepte pas de commandes supplémentaires tant que la commande actuelle n’est pas terminée.

Paramètres

-CimSession

Exécute l’applet de commande dans une session à distance ou sur un ordinateur distant. Entrez un nom d’ordinateur ou un objet de session, tel que la sortie d’une applet de commande New-CimSession ou Get-CimSession . La valeur par défaut est la session active sur l’ordinateur local.

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

-ComputerName

Spécifie un tableau de noms d'ordinateurs. L’applet de commande applique les paramètres de configuration aux ordinateurs spécifiés par ce paramètre.

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

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

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

-Credential

Spécifie un nom d'utilisateur et un mot de passe, sous la forme d'un objet PSCredential, pour l'ordinateur cible. Pour obtenir un objet PSCredential , utilisez l’applet de Get-Credential commande . Pour plus d'informations, voir Get-Help Get-Credential.

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

-JobName

Spécifie le nom convivial d'une tâche. Si vous spécifiez ce paramètre, l'applet de commande s'exécute en tant que tâche et retourne un objet Job.

Par défaut, Windows PowerShell attribue le nom JobN où N est un entier.

Si vous spécifiez le paramètre Wait, ne spécifiez pas ce paramètre.

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

-ThrottleLimit

Spécifie le nombre maximal d’opérations simultanées pouvant être établi pour exécuter l’applet de commande. Si ce paramètre est omis ou si une valeur de 0 est entrée, Windows PowerShell calcule une limite de limitation optimale pour l’applet de commande en fonction du nombre d’applets de commande CIM qui s’exécutent sur l’ordinateur. Le seuil de limitation s’applique uniquement à l’applet de commande active et non à la session ou à l’ordinateur.

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

-Wait

Indique que l’applet de commande bloque la console jusqu’à ce qu’elle termine toutes les tâches de configuration.

Si vous spécifiez ce paramètre, ne spécifiez pas le paramètre JobName.

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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

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