Partager via

Set-DscLocalConfigurationManager

  • Référence
Module:
PSDesiredStateConfiguration

Applique les paramètres du Gestionnaire de configuration local (LCM) aux nœuds.

Syntaxe

Set-DscLocalConfigurationManager
   [-Path] <String>
   [-Force]
   [[-ComputerName] <String[]>]
   [-Credential <PSCredential>]
   [-ThrottleLimit <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-DscLocalConfigurationManager
   [-Path] <String>
   [-Force]
   [-ThrottleLimit <Int32>]
   -CimSession <CimSession[]>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande Set-DscLocalConfigurationManager applique les paramètres LCM ou la méta-configuration aux nœuds. Spécifiez des ordinateurs en spécifiant des noms d’ordinateurs ou en utilisant des sessions CIM (Common Information Model). Si vous ne spécifiez pas d’ordinateur cible, l’applet de commande applique les paramètres à l’ordinateur local.

Exemples

Exemple 1 : Appliquer les paramètres LCM

Set-DscLocalConfigurationManager -Path "C:\DSC\Configurations\"

Cette commande applique les paramètres LCM de C:\DSC\Configurations\ aux nœuds ciblés. Après avoir reçu les paramètres, LCM les traite.

Avertissement

S’il existe plusieurs meta mofs pour le même ordinateur stocké dans le dossier spécifié, seul le premier méta mof est appliqué.

Exemple 2 : Appliquer des paramètres LCM à l’aide d’une session CIM

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

Cet exemple applique les paramètres LCM à un ordinateur et applique les paramètres. 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 applique les paramètres LCM pour le nœud ciblé de C:\DSC\Configurations\ à l’ordinateur identifié 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 les paramètres. Après avoir reçu les paramètres, LCM les traite.

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 métaconfiguration 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

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

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 un chemin d’accès de fichier d’un dossier qui contient des fichiers de paramètres de configuration. L’applet de commande publie et applique ces paramètres LCM 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.meta.mof.

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

-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

-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