Start-DscConfiguration
Applique la configuration à des nœuds.
Syntax
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 Start-DscConfiguration de commande 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 une tâche 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 en détail de ce que fait l'applet de commande lorsqu'elle applique des 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 à C:\DSC\Configurations\ tous les ordinateurs qui ont des paramètres dans ce dossier. La commande retourne des objets Job pour chaque nœud cible visé par le déploiement.
Exemple 2 : Appliquer les paramètres de configuration et attendre la fin de la configuration
Start-DscConfiguration -Path "C:\DSC\Configurations\" -Wait -VerboseCette commande applique la configuration de C:\DSC\Configurations\ à l’ordinateur local. La commande retourne des objets Job pour chaque nœud cible visé par le déploiement (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 progresse. 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 $SessionCet 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 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 NewCimSession.
La deuxième commande applique les paramètres de configuration à partir des C:\DSC\Configurations ordinateurs identifiés par les objets CimSession stockés dans la $Session variable. Dans cet exemple, la $Session variable contient une session CIM uniquement pour l’ordinateur nommé Server01. La commande applique la configuration. La commande crée des objets Job pour chaque ordinateur configuré.
Paramètres
-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 applet de commande New-CimSession ou Get-CimSession . La valeur par défaut est la session active sur l’ordinateur local.
| Type: | CimSession[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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[] |
| Aliases: | CN, ServerName |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| 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 |
-Credential
Spécifie un nom d'utilisateur et un mot de passe, sous la forme d'un objet PSCredential, pour l'ordinateur cible.
Pour obtenir un objet PSCredential , utilisez l’applet de Get-Credential commande .
Pour plus d'informations, voir Get-Help Get-Credential.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
Arrête l’opération de configuration en cours d’exécution sur l’ordinateur cible et commence la nouvelle opération Start-Configuration. Si la propriété RefreshMode du Configuration Manager local est définie sur Pull, la spécification de ce paramètre la remplace par Push.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobName
Spécifie le nom convivial d'une tâche. Si vous spécifiez ce paramètre, l'applet de commande s'exécute en tant que tâche 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
Spécifie le chemin d'accès d'un dossier qui contient les 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 |
| Default value: | None |
| 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. 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. Le seuil de limitation s’applique uniquement à l’applet de commande active et non à la session ou à l’ordinateur.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseExisting
Indique que cette applet de commande applique la configuration existante. La configuration peut exister sur l’ordinateur cible en utilisant 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 contenues dans Nouveautés de Windows PowerShell 5.0.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| 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 |
Liens associés
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour