Invoke-DscResource

  • Referenz
Modul:
PSDesiredStateConfiguration

Führt eine Methode einer angegebenen DSC-Ressource aus.

Syntax

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

Beschreibung

Das Invoke-DscResource Cmdlet führt eine Methode einer angegebenen DSC-Ressource (Windows PowerShell Desired State Configuration) aus. Legen Sie vor dem Ausführen dieses Cmdlets den Aktualisierungsmodus des lokalen Configuration Manager (LCM) auf Deaktiviert fest.

Dieses Cmdlet ruft eine DSC-Ressource direkt auf, ohne ein Konfigurationsdokument zu erstellen. Mithilfe dieses Cmdlets können Konfigurationsverwaltungsprodukte Fenster mithilfe von DSC-Ressourcen verwalten. Dieses Cmdlet ermöglicht auch das Debuggen von Ressourcen, wenn die DSC-Engine oder der LCM mit aktiviertem Debuggen ausgeführt wird.

Dieses Cmdlet funktioniert nicht mit zusammengesetzten Ressourcen. Zusammengesetzte Ressourcen sind parametrisierte Konfigurationen. Für die Verwendung zusammengesetzter Ressourcen ist der LCM erforderlich.

Beispiele

Beispiel 1: Aufrufen der Set-Methode einer Ressource durch Angeben der obligatorischen Eigenschaften

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

Dieser Befehl ruft die Set-Methode einer Ressource namens Log auf und gibt eine Message-Eigenschaft für sie an.

Beispiel 2: Aufrufen der Testmethode einer Ressource für ein angegebenes Modul

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

Mit diesem Befehl wird die Testmethode einer Ressource namens WindowsProcess aufgerufen, die sich im Modul PSDesiredStateConfiguration befindet.

Parameter

-Method

Gibt die Methode der Ressource an, die dieses Cmdlet aufruft. Zulässige Werte für diesen Parameter:

  • 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

Gibt den Namen des Moduls an, aus dem dieses Cmdlet die angegebene Ressource aufruft.

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

-Name

Gibt den Namen der zu startenden DSC-Ressource an.

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

-Property

Gibt den Namen der Ressourceneigenschaft und deren Wert in einer Hashtabelle als Schlüssel und Wert an. Verwenden Sie das Get-DscResource Cmdlet, um Ressourceneigenschaften und deren Typen zu ermitteln.

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

Ausgaben

Microsoft.Management.Infrastructure.CimInstance, System.Boolean