Megosztás:

Invoke-DscResource

Modul:
PSDesiredStateConfiguration Module

Egy megadott PowerShell Desired State Configuration (DSC) erőforrás metódusát futtatja.

Szintaxis

Default (Alapértelmezett) 

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

Leírás

A Invoke-DscResource parancsmag egy megadott PowerShell Desired State Configuration (DSC) erőforrás metódusát futtatja.

Ez a parancsmag közvetlenül, konfigurációs dokumentum létrehozása nélkül hív meg egy DSC-erőforrást. Ezzel a parancsmaggal a konfigurációkezelő termékek DSC-erőforrásokkal kezelhetik a Windows vagy a Linux rendszert.

Ez a parancsmag nem működik összetett erőforrásokkal. Az összetett erőforrások paraméteres konfigurációk. Az összetett erőforrások használatához az LCM szükséges.

Példák

1. példa: Egy erőforrás Set metódusának meghívása a kötelező tulajdonságainak megadásával

Ez a példa egy WindowsProcess nevű erőforrás Set metódusát hívja meg, és megadja a megadott Windows-folyamat elindításához szükséges kötelező elérési út és argumentumok tulajdonságokat.

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

2. példa: Erőforrás tesztmetódusának meghívása egy adott modulhoz

Ez a példa egy WindowsProcess nevű erőforrás teszt metódusát hívja meg, amely a PSDesiredStateConfiguration nevű modulban található.

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

Invoke-DscResource @SplatParam

Paraméterek

-Method

Megadja annak az erőforrásnak a metódusát, amelyet a parancsmag meghív. A paraméter elfogadható értékei a következők: Get, Set ésTest.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Elfogadott értékek:Get, Set, Test
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:2
Kötelező:True
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:False
Érték a maradék argumentumokból:False

-ModuleName

Megadja annak a modulnak a nevét, amely biztosítja a meghívni kívánt megadott DSC-erőforrást.

Paramétertulajdonságok

Típus:ModuleSpecification
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:1
Kötelező:False
Érték a csővezetékből:True
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-Name

Megadja a meghívni kívánt DSC-erőforrás nevét.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:0
Kötelező:True
Érték a csővezetékből:True
Érték a csővezetékből az ingatlan név szerint:True
Érték a maradék argumentumokból:False

-Property

Az erőforrástulajdonság nevét és értékét kulcsként és értékként adja meg egy kivonattáblában.

Paramétertulajdonságok

Típus:Hashtable
Alapértelmezett érték:None
Támogató vadkártyák:False
Don't Show:False

Paraméterhalmazok

(All)
Pozíció:3
Kötelező:True
Érték a csővezetékből:False
Érték a csővezetékből az ingatlan név szerint:False
Érték a maradék argumentumokból:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bemenetek

String

ModuleSpecification

Kimenetek

Object

Notes

  • A Windows PowerShell 5.1-ben az erőforrások a Rendszerkörnyezet alatt futottak, kivéve, ha a felhasználói környezet a PsDscRunAsCredential kulccsal van megadva. A PowerShell 7.0-ban az erőforrások a felhasználó környezetében futnak, és a PsDscRunAsCredential már nem támogatott. Ennek a kulcsnak a használata kivételt okoz a parancsmag számára.

  • A PowerShell 7-től Invoke-DscResource kezdve már nem támogatja a WMI DSC-erőforrások meghívását. Ez magában foglalja a PSDesiredStateConfigurationfájl- és naplóerőforrásait is.