Invoke-DscResource

  • Referens
Modul:
PSDesiredStateConfiguration

Kör en metod för en angiven DSC-resurs.

Syntax

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

Description

Cmdleten Invoke-DscResource kör en metod för en angiven Windows PowerShell Desired State Configuration resurs (DSC). Innan du kör den här cmdleten anger du uppdateringsläget för local Configuration Manager (LCM) till Inaktiverat.

Den här cmdleten anropar en DSC-resurs direkt utan att skapa ett konfigurationsdokument. Med den här cmdleten kan konfigurationshanteringsprodukter hantera fönster 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 Meddelande 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 testmetoden för en resurs med namnet WindowsProcess, som finns i modulen med namnet PSDesiredStateConfiguration.

Parametrar

-Method

Anger metoden för den resurs som denna cmdlet anropar. De acceptabla värdena för den här parametern är:

  • Get
  • Set
  • Test
Type:String
Accepted values:Get, Set, Test
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ModuleName

Anger namnet på modulen som den här cmdleten anropar den angivna resursen från.

Type:ModuleSpecification
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Anger namnet på DSC-resursen som ska startas.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:Hashtable
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Utdata

Microsoft.Management.Infrastructure.CimInstance, System.Boolean