Sdílet prostřednictvím

Invoke-DscResource

  • Reference
Modul:
PSDesiredStateConfiguration

Spustí metodu zadaného prostředku DSC.

Syntax

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

Description

Rutina Invoke-DscResource spustí metodu zadaného prostředku Windows PowerShell Desired State Configuration (DSC). Před spuštěním této rutiny nastavte režim aktualizace místní Configuration Manager (LCM) na Zakázáno.

Tato rutina vyvolá prostředek DSC přímo, aniž by vytvářela konfigurační dokument. Pomocí této rutiny můžou produkty pro správu konfigurace spravovat okna pomocí prostředků DSC. Tato rutina také umožňuje ladění prostředků, když běží modul DSC nebo LCM s povoleným laděním.

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í

Invoke-DscResource -Name Log -Method Set -Property @{Message = 'Hello World'} -ModuleName PSDesiredStateConfiguration

Tento příkaz vyvolá metodu Set prostředku s názvem Log a určí pro ni vlastnost Message .

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

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

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

Parametry

-Method

Určuje metodu prostředku, který tato rutina vyvolá. Tento parametr přijímá tyto hodnoty:

  • 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

Určuje název modulu, ze kterého tato rutina vyvolá zadaný prostředek.

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

-Name

Určuje název prostředku DSC, který se má spustit.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Property

Určuje název vlastnosti prostředku a její hodnotu v tabulce hash jako klíč a hodnotu. Get-DscResource Ke zjištění vlastností prostředků a jejich typů použijte rutinu .

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

Výstupy

Microsoft.Management.Infrastructure.CimInstance, System.Boolean