Invoke-DscResource

运行指定 DSC 资源的方法。

语法

Default (默认值)

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

说明

Invoke-DscResource cmdlet 运行指定的 Windows PowerShell Desired State Configuration (DSC) 资源的方法。 运行此 cmdlet 之前,请将本地配置管理器(LCM)的刷新模式设置为“已禁用”。

此 cmdlet 直接调用 DSC 资源,而无需创建配置文档。 使用此 cmdlet,配置管理产品可以使用 DSC 资源管理窗口。 当 DSC 引擎或 LCM 在启用调试时,此 cmdlet 还会启用资源调试。

此 cmdlet 不适用于复合资源。 复合资源是参数化配置。 使用复合资源需要 LCM。

示例

示例 1:通过指定资源的必需属性调用 Set 方法

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

此命令调用名为 Log 的资源的 Set 方法,并为其指定 消息 属性。

示例 2:为指定的模块调用资源的 Test 方法

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

此命令调用名为 WindowsProcess 的资源的 Test 方法,该方法位于名为 PSDesiredStateConfiguration 的模块中。

参数

-Method

指定此 cmdlet 调用的资源的方法。 此参数的可接受值为:

  • Get
  • Set
  • Test

参数属性

类型:String
默认值:None
接受的值:Get, Set, Test
支持通配符:False
不显示:False

参数集

(All)
Position:1
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ModuleName

指定此 cmdlet 从中调用指定资源的模块的名称。

参数属性

类型:ModuleSpecification
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Name

指定要启动的 DSC 资源的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:0
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Property

将哈希表中的资源属性名称和值分别指定为键和值。 使用 Get-DscResource cmdlet 发现资源属性及其类型。

参数属性

类型:Hashtable
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输出

Microsoft.Management.Infrastructure.CimInstance, System.Boolean