Update-DscConfiguration
Vérifie le serveur collecteur pour obtenir une configuration mise à jour et l’applique.
Syntaxe
ComputerNameSet (Par défaut)
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>]
Description
L’applet de commande Update-DscConfiguration se connecte à un serveur collecteur, 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 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 collecteur 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 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 sur 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 de commande New-CimSession, puis stocke l’objet CimSession dans la variable $Session. La commande vous invite à entrer un mot de passe. Pour plus d’informations, tapez Get-Help New-CimSession.
La deuxième commande met à jour l’ordinateur spécifié dans le 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 distante ou sur un ordinateur distant. Entrez un nom d’ordinateur ou un objet de session, tel que la sortie d’un new-CimSession ou applet de commande Get-CimSession. La valeur par défaut est la session active sur l’ordinateur local.
Propriétés du paramètre
| Type: | |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
CimSessionSet
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | CN, Nom du serveur |
Jeux de paramètres
ComputerNameSet
| Position: | 1 |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Confirm
Vous invite à confirmer avant d’exécuter l’applet de commande.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Credential
Spécifie un nom d’utilisateur et un mot de passe, en tant qu’objet PSCredential, pour l’ordinateur cible. Pour obtenir un objet PSCredential, utilisez l’applet de commande Get-Credential. Pour plus d’informations, tapez Get-Help Get-Credential.
Propriétés du paramètre
| Type: | PSCredential |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
ComputerNameSet
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-JobName
Spécifie un nom convivial pour un travail. Si vous spécifiez ce paramètre, l’applet de commande s’exécute en tant que travail 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.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ThrottleLimit
Spécifie le nombre maximal d’opérations simultanées qui peuvent être établies 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. La limite de limitation s’applique uniquement à l’applet de commande actuelle, et non à la session ou à l’ordinateur.
Propriétés du paramètre
| Type: | Int32 |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
