Invoke-​Dsc​Resource

Runs a method of a specified DSC resource.

Syntax

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

Description

The Invoke-DscResource cmdlet runs a method of a specified Windows PowerShell Desired State Configuration (DSC) resource. Before you run this cmdlet, set the refresh mode of the Local Configuration Manager (LCM) to Disabled.

This cmdlet invokes a DSC resource directly, without creating a configuration document. Using this cmdlet, configuration management products can manage windows by using DSC resources. This cmdlet also enables debugging of resources when the DSC engine or LCM is running with debugging enabled.

Examples

Example 1: Invoke the Set method of a resource by specifying its mandatory properties

PS C:\> Invoke-DscResource -Name Log -Method Set -Property @{Message = 'Hello World'}

This command invokes the Set method of a resource named Log and specifies a Message property for it.

Example 2: Invoke the Test method of a resource for a specified module

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

This command invokes the Test method of a resource named WindowsProcess, which is in the module named PSDesiredStateConfiguration.

Required Parameters

-Method

Specifies the method of the resource that this cmdlet invokes. The acceptable values for this parameter are: Get, Set, and Test.

Type:String
Parameter Sets:Get, Set, Test
Position:1
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-ModuleName

Specifies the name of the module from which this cmdlet invokes the specified resource.

Type:ModuleSpecification
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Name

Specifies the name of the DSC resource to start.

Type:String
Position:0
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Property

Specifies the resource property name and its value in a hash table as key and value, respectively. Use the Get-DscResource cmdlet to discover resource properties and their types.

Type:Hashtable
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

Outputs

Microsoft.Management.Infrastructure.CimInstance, System.Boolean