Restore-DscConfiguration
Réapplique la configuration précédente pour le nœud.
Syntaxe
Default (Par défaut)
Restore-DscConfiguration
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Restore-DscConfiguration réapplique la configuration précédente pour le nœud, si une configuration précédente existe. Spécifiez des ordinateurs à l’aide de sessions CIM (Common Information Model).
Si vous ne spécifiez pas d’ordinateur cible, l’applet de commande restaure la configuration de l’ordinateur local. S’il n’existe aucune configuration précédente pour un nœud particulier, cette applet de commande retourne un message d’erreur.
Cette applet de commande ne prend pas en charge le paramètre Confirmer.
Exemples
Exemple 1 : Restaurer la configuration de l’ordinateur local
Restore-DscConfiguration
Cette commande restaure la configuration de l’ordinateur local.
Exemple 2 : Restaurer la configuration d’un ordinateur spécifié
$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Restore-DscConfiguration -CimSession $Session
Cet exemple restaure la configuration sur un ordinateur spécifié par une session CIM. L’exemple crée une session CIM pour un ordinateur nommé Server01 à utiliser avec l’applet de commande. Vous pouvez également créer un tableau de sessions CIM pour appliquer l’applet de commande à plusieurs ordinateurs spécifiés.
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 restaure la configuration des ordinateurs identifiés par les objets cimSession CimSession stockés dans la variable $Session, dans ce cas, l’ordinateur nommé Server01.
Paramètres
-AsJob
Indique que cette applet de commande exécute la commande en tant que travail en arrière-plan.
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 |
-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’une New-CimSession ou d’une applet de commande Get-CimSession.
Propriétés du paramètre
| Type: | |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | session |
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 |
-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 |
-ThrottleLimit
Spécifie le nombre maximal d’opérations simultanées qui peuvent être établies pour exécuter l’applet de commande.
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 |
-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.
