Partager via

Test-DscConfiguration

  • Référence
Module:
PSDesiredStateConfiguration

Teste si la configuration réelle sur les nœuds correspond à la configuration souhaitée.

Syntaxe

Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-Detailed]
    [<CommonParameters>]
Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-Path] <String>
    [<CommonParameters>]
Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    -ReferenceConfiguration <String>
    [<CommonParameters>]
Test-DscConfiguration
    [-ThrottleLimit <Int32>]
    -CimSession <CimSession[]>
    [-AsJob]
    [-Path] <String>
    [<CommonParameters>]
Test-DscConfiguration
    [-ThrottleLimit <Int32>]
    -CimSession <CimSession[]>
    [-AsJob]
    -ReferenceConfiguration <String>
    [<CommonParameters>]
Test-DscConfiguration
    [-ThrottleLimit <Int32>]
    -CimSession <CimSession[]>
    [-AsJob]
    [-Detailed]
    [<CommonParameters>]

Description

L’applet de commande Test-DscConfiguration teste si la configuration réelle sur les nœuds correspond à la configuration souhaitée. Spécifiez les ordinateurs pour lesquels vous souhaitez tester les configurations à l’aide de noms d’ordinateurs ou de sessions CIM (Common Information Model). Si vous ne spécifiez pas d’ordinateur cible, l’applet de commande teste la configuration de l’ordinateur local.

Si les configurations souhaitées et réelles correspondent, l’applet de commande retourne une valeur de chaîne de « True ». Sinon, elle retourne une valeur de chaîne de « False ».

Exemples

Exemple 1 : Tester la configuration de l’ordinateur local

Test-DscConfiguration

Cette commande teste la configuration de l’ordinateur local.

Exemple 2 : Tester la configuration d’un ordinateur spécifié

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

Cet exemple de configuration de test à partir 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 é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 teste la configuration des ordinateurs identifiés par les objets CimSession stockés dans la variable $Session, dans ce cas, l’ordinateur nommé Server01.

Exemple 3 : Tester des configurations avec des résultats détaillés

Test-DscConfiguration -ComputerName "Server01", "Server02", "Server03" -Detailed

Cette commande teste les configurations d’un ensemble d’ordinateurs spécifiés par le paramètre ComputerName et retourne des informations détaillées qui incluent l’état global, les ressources qui se trouvent dans l’état souhaité, les ressources qui ne sont pas dans l’état souhaité et le nom de l’ordinateur souhaité.

Exemple 4 : Tester les configurations spécifiées dans un dossier

Test-DscConfiguration -Path "C:\Dsc\Configurations"

Cette commande teste les configurations définies dans un dossier spécifié par le paramètre Path. Les configurations sont testées sur un ensemble d’ordinateurs, chacun identifié par le nom de fichier du fichier de configuration.

Exemple 5 : Tester les configurations spécifiées dans un fichier

Test-DscConfiguration -ReferenceConfiguration "C:\Dsc\Configurations\WebServer.mof" -ComputerName "Server01", "Server02", "Server03"

Cette commande teste une configuration définie dans un fichier par rapport à un ensemble d’ordinateurs spécifié par le paramètre ComputerName.

Paramètres

-AsJob

Indique que cette applet de commande exécute la commande en tant que travail en arrière-plan.

Si vous spécifiez le paramètre AsJob, la commande retourne un objet qui représente le travail, puis affiche l’invite de commandes. Vous pouvez continuer à travailler dans la session jusqu’à ce que le travail se termine. Le travail est créé sur l’ordinateur local et les résultats des ordinateurs distants sont automatiquement retournés à l’ordinateur local. Pour gérer le travail, utilisez les applets de commande Job. Pour obtenir les résultats du travail, utilisez l’applet de commande Receive-Job.

Pour utiliser ce paramètre, les ordinateurs locaux et distants doivent être configurés pour la communication à distance, et sur Windows Vista et les versions ultérieures du système d’exploitation Windows, vous devez ouvrir Windows PowerShell avec l’option Exécuter en tant qu’administrateur. Pour plus d’informations, consultez about_Remote_Requirements.

Pour plus d’informations sur les travaux en arrière-plan Windows PowerShell, consultez about_Jobs et about_Remote_Jobs.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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’un new-CimSession ou applet de commande Get-CimSession. La valeur par défaut est la session active sur l’ordinateur local.

Type:CimSession[]
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ComputerName

Spécifie un tableau de noms d’ordinateurs sur lequel cette applet de commande teste la configuration. L’applet de commande teste le document de configuration à l’emplacement spécifié par le paramètre Path sur ces ordinateurs.

Type:String[]
Alias:CN, ServerName
Position:1
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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.

Type:PSCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Detailed

Indique que cette applet de commande retourne un résultat détaillé de la comparaison du document de configuration avec l’état souhaité des nœuds. Le résultat inclut des informations telles que l’état global, les ressources qui se trouvent dans l’état souhaité, les ressources qui ne sont pas dans l’état souhaité et le nom de l’ordinateur.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Path

Spécifie le chemin d’accès d’un dossier qui contient des fichiers de document de configuration. L’applet de commande teste la configuration par rapport à l’état souhaité des ordinateurs spécifiés par le paramètre ComputerName ou CimSession.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ReferenceConfiguration

Spécifie le chemin d’accès du fichier de document de configuration. Cette applet de commande teste la configuration par rapport à l’état réel des ordinateurs spécifiés par le paramètre ComputerName ou CimSession.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False