Udostępnij przez

Invoke-DscResource

Moduł:
PSDesiredStateConfiguration Module

Uruchamia metodę określonego zasobu konfiguracji żądanego stanu programu PowerShell (DSC).

Składnia

Default (Domyślne) 

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

Opis

Polecenie Invoke-DscResource cmdlet uruchamia metodę określonego zasobu konfiguracji żądanego stanu (DSC) programu PowerShell.

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ć systemem Windows lub Linux z zasobami DSC.

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

W tym przykładzie wywoływana jest metoda Set zasobu o nazwie WindowsProcess i udostępnia obowiązkowe właściwości Path i Arguments w celu uruchomienia określonego procesu systemu Windows.

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

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

W tym przykładzie wywoływana jest metoda Test zasobu o nazwie WindowsProcess, który znajduje się w module o nazwie PSDesiredStateConfiguration.

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

Invoke-DscResource @SplatParam

Parametry

-Method

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

Właściwości parametrów

Typ:String
Wartość domyślna:None
Akceptowane wartości:Get, Set, Test
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:2
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-ModuleName

Określa nazwę modułu udostępniającego określony zasób DSC do wywołania.

Właściwości parametrów

Typ:ModuleSpecification
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:1
Obowiązkowy:False
Wartość z pipeline:True
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-Name

Określa nazwę zasobu DSC do wywołania.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:0
Obowiązkowy:True
Wartość z pipeline:True
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-Property

Określa nazwę właściwości zasobu i jej wartość w tabeli skrótów odpowiednio jako klucz i wartość.

Właściwości parametrów

Typ:Hashtable
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:3
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Wejścia

String

ModuleSpecification

Wyjść

Object

Notatki

  • W programie Windows PowerShell 5.1 zasoby są uruchamiane w kontekście systemu, chyba że określono je w kontekście użytkownika przy użyciu klucza PsDscRunAsCredential. W programie PowerShell 7.0 zasoby są uruchamiane w kontekście użytkownika, a element PsDscRunAsCredential nie jest już obsługiwany. Użycie tego klucza powoduje, że polecenie cmdlet zgłasza wyjątek.

  • Od programu PowerShell 7 Invoke-DscResource nie obsługuje już wywoływania zasobów DSC usługi WMI. Obejmuje to zasoby File i Log w PSDesiredStateConfiguration.