Partager via

Invoke-DscResource

  • Référence
Module:
PSDesiredStateConfiguration

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

Syntax

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

Description

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

Cette cmdlet 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 permet également le débogage des ressources lorsque le moteur DSC ou le gestionnaire de gestion LCM est en cours d’exécution 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 valides pour ce paramètre sont :

  • Get
  • Set
  • Test
Type:String
Accepted values:Get, Set, Test
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ModuleName

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

Type:ModuleSpecification
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Property

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

Type:Hashtable
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Sorties

Microsoft.Management.Infrastructure.CimInstance, System.Boolean