Invoke-DscResource

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

Cmdleten Invoke-DscResource kör en metod för en angiven DSC-resurs (PowerShell Desired State Configuration).

Den här cmdleten anropar en DSC-resurs direkt, utan att skapa ett konfigurationsdokument. Med den här cmdleten kan konfigurationshanteringsprodukter hantera windows eller Linux med DSC-resurser.

Den här cmdleten fungerar inte med sammansatta resurser. Sammansatta resurser är parametriserade konfigurationer. Användning av sammansatta resurser kräver LCM.

Det här exemplet anropar metoden Set för en resurs med namnet WindowsProcess och tillhandahåller obligatoriska Path och Argument egenskaper för att starta den angivna Windows-processen.

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

I det här exemplet anropas metoden Test för en resurs med namnet WindowsProcess, som finns i modulen med namnet PSDesiredStateConfiguration.

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

Invoke-DscResource @SplatParam

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

• I Windows PowerShell 5.1 kördes resurser under systemkontexten om de inte anges med användarkontext med hjälp av nyckeln PsDscRunAsCredential. I PowerShell 7.0 körs resurser i användarens kontext och PsDscRunAsCredential- stöds inte längre. Om du använder den här nyckeln utlöser cmdleten ett undantag.

• Från och med PowerShell 7 har Invoke-DscResource inte längre stöd för att anropa WMI DSC-resurser. Detta inkluderar resurserna File och Log i PSDesiredStateConfiguration.