Restore-DscConfiguration

  • Référence
Module:
PSDesiredStateConfiguration

Réapplique la configuration précédente pour le nœud.

Syntax

Restore-DscConfiguration
       [-CimSession <CimSession[]>]
       [-ThrottleLimit <Int32>]
       [-AsJob]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

L’applet Restore-DscConfiguration de commande réapplique la configuration précédente pour le nœud, si une configuration précédente existe. Spécifiez les 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 Confirm .

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 d'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 aussi 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 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 restaure la configuration des ordinateurs identifiés par les objets CimSession stockés dans la $Session variable, en l’occurrence 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.

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

-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 New-CimSession applet de commande ou Get-CimSession .

Type:CimSession[]
Aliases:Session
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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

-ThrottleLimit

Spécifie le nombre maximal d’opérations simultanées pouvant être établi pour exécuter l’applet de commande.

Type:Int32
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