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 Invoke-DscResource cmdlet uruchamia metodę określonego zasobu Windows PowerShell Desired State Configuration (DSC). Przed uruchomieniem tego polecenia cmdlet ustaw tryb odświeżania lokalnego 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ą sparametryzowane konfiguracje. Korzystanie z zasobów złożonych wymaga narzędzia 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 dla tego parametru to:

  • 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

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

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

-Name

Określa nazwę zasobu DSC do uruchomienia.

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

-Property

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

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

Dane wyjściowe

Microsoft.Management.Infrastructure.CimInstance, System.Boolean