Invoke-DscResource
Kör en metod för en angiven DSC-resurs.
Syntax
Default (Standard)
Invoke-DscResource
[-Name] <String>
[-Method] <String>
-ModuleName <ModuleSpecification>
-Property <Hashtable>
[<CommonParameters>]
Description
Cmdleten Invoke-DscResource kör en metod för en angiven DSC-resurs (Windows PowerShell Desired State Configuration). Innan du kör den här cmdleten anger du uppdateringsläget för LCM (Local Configuration Manager) till Inaktiverad.
Den här cmdleten anropar en DSC-resurs direkt, utan att skapa ett konfigurationsdokument. Med den här cmdleten kan konfigurationshanteringsprodukter hantera windows med hjälp av DSC-resurser. Den här cmdleten möjliggör också felsökning av resurser när DSC-motorn eller LCM körs med felsökning aktiverat.
Den här cmdleten fungerar inte med sammansatta resurser. Sammansatta resurser är parametriserade konfigurationer. Användning av sammansatta resurser kräver LCM.
Exempel
Exempel 1: Anropa metoden Set för en resurs genom att ange dess obligatoriska egenskaper
Invoke-DscResource -Name Log -Method Set -Property @{Message = 'Hello World'} -ModuleName PSDesiredStateConfiguration
Det här kommandot anropar metoden Set för en resurs med namnet Log och anger egenskapen Message för den.
Exempel 2: Anropa testmetoden för en resurs för en angiven modul
Invoke-DscResource -Name WindowsProcess -Method Test -Property @{Path = 'C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe'; Arguments = ''} -ModuleName PSDesiredStateConfiguration
Det här kommandot anropar metoden Test för en resurs med namnet WindowsProcess, som finns i modulen PSDesiredStateConfiguration.
Parametrar
-Method
Anger metoden för den resurs som den här cmdleten anropar. De godtagbara värdena för den här parametern är:
GetSetTest
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Godkända värden: | Get, Set, Test |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | 1 |
| Obligatorisk: | True |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-ModuleName
Anger namnet på modulen som den här cmdleten anropar den angivna resursen från.
Parameteregenskaper
| Typ: | ModuleSpecification |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | True |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-Name
Anger namnet på den DSC-resurs som ska startas.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | 0 |
| Obligatorisk: | True |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-Property
Anger resursegenskapens namn och dess värde i en hash-tabell som nyckel respektive värde.
Använd cmdleten Get-DscResource för att identifiera resursegenskaper och deras typer.
Parameteregenskaper
| Typ: | Hashtable |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | True |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
CommonParameters
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.
