Udostępnij za pośrednictwem

Invoke-DscResource

  • Odwołanie
Moduł:
PSDesiredStateConfiguration

Uruchamia metodę określonego zasobu DSC.

Składnia

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

Opis

Polecenie cmdlet Invoke-DscResource uruchamia metodę określonego zasobu konfiguracji żądanego stanu (DSC) programu Windows PowerShell. Przed uruchomieniem tego polecenia cmdlet ustaw tryb odświeżania programu Local Configuration Manager (LCM) na Wyłączone.

To polecenie cmdlet wywołuje bezpośrednio zasób DSC bez tworzenia dokumentu konfiguracji. Za pomocą tego polecenia cmdlet produkty do zarządzania konfiguracją mogą zarządzać oknami przy użyciu zasobów DSC. To polecenie cmdlet umożliwia również debugowanie zasobów, gdy aparat DSC lub LCM jest uruchomiony z włączonym debugowaniem.

To polecenie cmdlet nie działa z zasobami złożonymi. Zasoby złożone są sparametryzowanymi konfiguracjami. Korzystanie z zasobów złożonych wymaga menedżera LCM.

Przykłady

Przykład 1. Wywołaj metodę Set zasobu, określając jej obowiązkowe właściwości

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

To polecenie wywołuje metodę Set zasobu o nazwie Log i określa dla niego właściwość Message.

Przykład 2. Wywoływanie metody testowej zasobu dla określonego modułu

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

To polecenie wywołuje metodę Test zasobu o nazwie WindowsProcess, który znajduje się w module o nazwie PSDesiredStateConfiguration.

Parametry

-Method

Określa metodę zasobu, który wywołuje to polecenie cmdlet. Dopuszczalne wartości tego parametru to:

  • Get
  • Set
  • Test
Typ:String
Dopuszczalne wartości:Get, Set, Test
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ModuleName

Określa nazwę modułu, z którego to polecenie cmdlet wywołuje określony zasób.

Typ:ModuleSpecification
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę zasobu DSC do uruchomienia.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Property

Określa nazwę właściwości zasobu i jej wartość w tabeli skrótów odpowiednio jako klucz i wartość. Użyj polecenia cmdlet Get-DscResource, aby odnaleźć właściwości zasobów i ich typy.

Typ:Hashtable
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wyjściowe

Microsoft.Management.Infrastructure.CimInstance, System.Boolean