Partager via

Start-DscConfiguration

  • Référence
Module:
PSDesiredStateConfiguration

Applique la configuration aux nœuds.

Syntaxe

Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-Path] <String>]
     [[-ComputerName] <String[]>]
     [-Credential <PSCredential>]
     [-ThrottleLimit <Int32>]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-Path] <String>]
     -CimSession <CimSession[]>
     [-ThrottleLimit <Int32>]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-ComputerName] <String[]>]
     [-Credential <PSCredential>]
     [-ThrottleLimit <Int32>]
     [-UseExisting]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     -CimSession <CimSession[]>
     [-ThrottleLimit <Int32>]
     [-UseExisting]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

L’applet de commande Start-DscConfiguration applique la configuration aux nœuds. Lorsqu’elle est utilisée avec le paramètre UseExisting, la configuration existante sur l’ordinateur cible est appliquée. Spécifiez les ordinateurs auxquels vous souhaitez appliquer la configuration en spécifiant des noms d’ordinateurs ou à l’aide de sessions CIM (Common Information Model).

Par défaut, cette applet de commande crée un travail et retourne un objet Job. Pour plus d’informations sur les travaux en arrière-plan, tapez Get-Help about_Jobs. Pour utiliser cette applet de commande de manière interactive, spécifiez le paramètre Wait.

Spécifiez le paramètre Verbose pour afficher les détails de ce que fait l’applet de commande lorsqu’elle applique les paramètres de configuration.

Exemples

Exemple 1 : Appliquer les paramètres de configuration

Start-DscConfiguration -Path "C:\DSC\Configurations\"

Cette commande applique les paramètres de configuration de C:\DSC\Configurations\ à chaque ordinateur disposant de paramètres dans ce dossier. La commande retourne 'objet Job pour chaque nœud cible déployé.

Exemple 2 : Appliquer les paramètres de configuration et attendre la fin de la configuration

Start-DscConfiguration -Path "C:\DSC\Configurations\" -Wait -Verbose

Cette commande applique la configuration de C:\DSC\Configurations\ à l’ordinateur local. La commande retourne 'objet Job pour chaque nœud cible déployé sur, dans ce cas, uniquement l’ordinateur local. Cet exemple spécifie le paramètre verbose. Par conséquent, la commande envoie des messages à la console au fur et à mesure qu’elle se poursuit. La commande inclut le paramètre Wait. Par conséquent, vous ne pouvez pas utiliser la console tant que la commande n’a pas terminé toutes les tâches de configuration.

Exemple 3 : Appliquer des paramètres de configuration à l’aide d’une session CIM

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Start-DscConfiguration -Path "C:\DSC\Configurations\" -CimSession $Session

Cet exemple applique les paramètres de configuration à un ordinateur spécifié. 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 NewCimSession.

La deuxième commande applique les paramètres de configuration de C:\DSC\Configurations aux ordinateurs identifiés par les objets CimSession stockés dans la variable $Session. Dans cet exemple, la variable $Session contient une session CIM uniquement pour l’ordinateur nommé Server01. La commande applique la configuration. La commande crée objets job pour chaque ordinateur configuré.

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.

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. Ce paramètre limite les ordinateurs qui ont des documents de configuration dans le paramètre Path à ceux spécifiés dans le tableau.

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

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
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

-Force

Arrête l’opération de configuration en cours d’exécution sur l’ordinateur cible et démarre la nouvelle opération de Start-Configuration. Si la propriété RefreshMode du Gestionnaire de configuration local est définie sur pull, en spécifiant que ce paramètre le modifie en Push.

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

-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.

Type:String
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 un chemin d’accès de fichier d’un dossier qui contient des fichiers de paramètres de configuration. Cette applet de commande publie et applique ces paramètres de configuration aux ordinateurs qui ont des fichiers de paramètres dans le chemin spécifié. Chaque nœud cible doit avoir un fichier de paramètres au format suivant : <NetBIOS Name>.mof.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:False
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

-UseExisting

Indique que cette applet de commande applique la configuration existante. La configuration peut exister sur l’ordinateur cible en adoptant Start-DscConfiguration ou en publiant à l’aide de l’applet de commande Publish-DscConfiguration.

Avant de spécifier ce paramètre pour cette applet de commande, passez en revue les informations de Nouveautés de Windows PowerShell 5.0.

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

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

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