Invoke-DscResource
Exécute une méthode d’une ressource DSC spécifiée.
Syntaxe
Default (Par défaut)
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 :
GetSetTest
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Valeurs acceptées: | Get, Set, Test |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-ModuleName
Spécifie le nom du module à partir duquel cette applet de commande appelle la ressource spécifiée.
Propriétés du paramètre
| Type: | ModuleSpecification |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Name
Spécifie le nom de la ressource DSC à démarrer.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | Hashtable |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
