Sdílet prostřednictvím

Invoke-DscResource

Modul:
PSDesiredStateConfiguration Module

Spustí metodu zadaného prostředku PowerShell Desired State Configuration (DSC).

Syntaxe

Default (Výchozí) 

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

Description

Rutina Invoke-DscResource spustí metodu určeného prostředku PowerShell Desired State Configuration (DSC).

Tato rutina vyvolá prostředek DSC přímo bez vytvoření konfiguračního dokumentu. Pomocí této rutiny mohou produkty pro správu konfigurace spravovat systémy Windows nebo Linux pomocí prostředků DSC.

Tato rutina nefunguje se složenými prostředky. Složené prostředky jsou parametrizované konfigurace. Použití složených prostředků vyžaduje LCM.

Příklady

Příklad 1: Vyvolání metody Set prostředku zadáním jeho povinných vlastností

Tento příklad vyvolá metodu Set prostředku s názvem WindowsProcess a poskytne povinné vlastnosti Path a Arguments pro spuštění určeného procesu systému Windows.

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

Příklad 2: Vyvolání testovací metody prostředku pro zadaný modul

Tento příklad vyvolá metodu Test prostředku s názvem WindowsProcess, který je v modulu s názvem PSDesiredStateConfiguration.

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

Invoke-DscResource @SplatParam

Parametry

-Method

Určuje metodu prostředku, který tato rutina vyvolá. Přijatelné hodnoty pro tento parametr jsou: Get, Set a Test.

Vlastnosti parametru

Typ:String
Default value:None
Přípustné hodnoty:Get, Set, Test
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:2
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-ModuleName

Určuje název modulu poskytujícího určený prostředek DSC, který má být vyvolán.

Vlastnosti parametru

Typ:ModuleSpecification
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:1
Povinné:False
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Name

Určuje název prostředku DSC, který má být vyvolán.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:0
Povinné:True
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Property

Určuje název vlastnosti prostředku a jeho hodnotu v tabulce hash jako klíč a hodnotu.

Vlastnosti parametru

Typ:Hashtable
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:3
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

String

ModuleSpecification

Výstupy

Object

Poznámky

  • V Windows PowerShell 5.1 se prostředky spouštěly v kontextu systému, pokud nebylo zadáno s kontextem uživatele pomocí klíče PsDscRunAsCredential. V PowerShellu 7.0 se prostředky spouštějí v kontextu uživatele a PsDscRunAsCredential se už nepodporuje. Použití tohoto klíče způsobí, že rutina vyvolá výjimku.

  • Od PowerShellu 7 Invoke-DscResource už nepodporuje vyvolání prostředků WMI DSC. To zahrnuje prostředky File a Log v PSDesiredStateConfiguration.