Partager via

Invoke-DscResource

  • Référence
Module:
PSDesiredStateConfiguration

Exécute une méthode d’une ressource DSC spécifiée.

Syntaxe

Invoke-DscResource
      [-Name] <String>
      [-Method] <String>
      -ModuleName <ModuleSpecification>
      -Property <Hashtable>
      [<CommonParameters>]

Description

L’applet de commande Invoke-DscResource exécute une méthode d’une ressource DSC (Desired State Configuration) Windows PowerShell spécifiée. Avant d’exécuter cette applet de commande, définissez le mode d’actualisation du Gestionnaire de configuration local (LCM) sur Désactivé.

Cette applet de commande appelle directement une ressource DSC, sans créer de document de configuration. À l’aide de cette applet de commande, les produits de gestion de la configuration peuvent gérer les fenêtres à l’aide de ressources DSC. Cette applet de commande active également le débogage des ressources lorsque le moteur DSC ou le gestionnaire de configuration local s’exécute avec le débogage activé.

Cette applet de commande ne fonctionne pas avec les ressources composites. Les ressources composites sont des configurations paramétrables. L’utilisation de ressources composites nécessite le gestionnaire de configuration local.

Exemples

Exemple 1 : Appeler la méthode Set d’une ressource en spécifiant ses propriétés obligatoires

Invoke-DscResource -Name Log -Method Set -Property @{Message = 'Hello World'} -ModuleName PSDesiredStateConfiguration

Cette commande appelle la méthode Set d’une ressource nommée Log et spécifie une propriété Message pour celle-ci.

Exemple 2 : Appeler la méthode test d’une ressource pour un module spécifié

Invoke-DscResource -Name WindowsProcess -Method Test -Property @{Path = 'C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe'; Arguments = ''} -ModuleName PSDesiredStateConfiguration

Cette commande appelle la méthode Test d’une ressource nommée WindowsProcess, qui se trouve dans le module nommé PSDesiredStateConfiguration.

Paramètres

-Method

Spécifie la méthode de la ressource appelée par cette applet de commande. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Get
  • Set
  • Test
Type:String
Valeurs acceptées:Get, Set, Test
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ModuleName

Spécifie le nom du module à partir duquel cette applet de commande appelle la ressource spécifiée.

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

-Name

Spécifie le nom de la ressource DSC à démarrer.

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

-Property

Spécifie le nom de la propriété de ressource et sa valeur dans une table de hachage en tant que clé et valeur, respectivement. Utilisez l’applet de commande Get-DscResource pour découvrir les propriétés des ressources et leurs types.

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

Sorties

Microsoft.Management.Infrastructure.CimInstance, System.Boolean