Invoke-DscResource

参考

模块:: PSDesiredStateConfiguration

运行指定 DSC 资源的方法。

语法

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
接受的值:	Get, Set, Test
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-ModuleName

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

类型:	ModuleSpecification
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Name

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

类型:	String
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Property

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

类型:	Hashtable
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

输出

Microsoft.Management.Infrastructure.CimInstance, System.Boolean

通过