Freigeben über

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 cmdlet Invoke-DscResource führt eine Methode einer angegebenen Windows PowerShell Desired State Configuration (DSC)-Ressource aus. Bevor Sie dieses Cmdlet ausführen, legen Sie den Aktualisierungsmodus des Local 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 Windows mithilfe von DSC-Ressourcen verwalten. Dieses Cmdlet ermöglicht auch das Debuggen von Ressourcen, wenn das DSC-Modul oder LCM mit aktiviertem Debugging ausgeführt wird.

Dieses Cmdlet funktioniert nicht mit zusammengesetzten Ressourcen. Zusammengesetzte Ressourcen sind parametrisierte Konfigurationen. Für die Verwendung zusammengesetzter Ressourcen ist das 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 dafür 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 Test Methode einer Ressource namens "WindowsProcess" aufgerufen, die sich im Modul "PSDesiredStateConfiguration" befindet.

Parameter

-Method

Gibt die Methode der Ressource an, die dieses Cmdlet aufruft. Die zulässigen Werte für diesen Parameter sind:

  • Get
  • Set
  • Test
Typ:String
Zulässige Werte:Get, Set, Test
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ModuleName

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

Typ:ModuleSpecification
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen der zu startenden DSC-Ressource an.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Property

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

Typ:Hashtable
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Ausgaben

Microsoft.Management.Infrastructure.CimInstance, System.Boolean