Delen via

Invoke-DscResource

  • Referentie
Module:
PSDesiredStateConfiguration

Hiermee wordt een methode van een opgegeven DSC-resource uitgevoerd.

Syntax

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

Description

Met de Invoke-DscResource cmdlet wordt een methode van een opgegeven dsc-resource (Windows PowerShell Desired State Configuration) uitgevoerd. Voordat u deze cmdlet uitvoert, stelt u de vernieuwingsmodus van LCM (Local Configuration Manager) in op Uitgeschakeld.

Met deze cmdlet wordt een DSC-resource rechtstreeks aangeroepen, zonder een configuratiedocument te maken. Met deze cmdlet kunnen configuratiebeheerproducten windows beheren met behulp van DSC-resources. Deze cmdlet maakt ook foutopsporing van resources mogelijk wanneer de DSC-engine of LCM wordt uitgevoerd met foutopsporing ingeschakeld.

Deze cmdlet werkt niet met samengestelde resources. Samengestelde resources zijn geparameteriseerde configuraties. Voor het gebruik van samengestelde resources is de LCM vereist.

Voorbeelden

Voorbeeld 1: de methode Set van een resource aanroepen door de verplichte eigenschappen op te geven

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

Met deze opdracht wordt de methode Set van een resource met de naam Logboek aangeroepen en wordt de eigenschap Message opgegeven.

Voorbeeld 2: De testmethode van een resource voor een opgegeven module aanroepen

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

Met deze opdracht wordt de testmethode aangeroepen van een resource met de naam WindowsProcess, die zich in de module PSDesiredStateConfiguration bevindt.

Parameters

-Method

Hiermee geeft u de methode van de resource die deze cmdlet aanroept. De aanvaardbare waarden voor deze parameter zijn:

  • 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

Hiermee geeft u de naam van de module van waaruit deze cmdlet de opgegeven resource aanroept.

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

-Name

Hiermee geeft u de naam van de DSC-resource te starten.

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

-Property

Hiermee geeft u de naam van de resource-eigenschap en de bijbehorende waarde in een hash-tabel op als respectievelijk sleutel en waarde. Gebruik de Get-DscResource cmdlet om resource-eigenschappen en hun typen te detecteren.

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

Uitvoerwaarden

Microsoft.Management.Infrastructure.CimInstance, System.Boolean