Invoke-DscResource

  • 参考
模块:
PSDesiredStateConfiguration

运行指定 DSC 资源的方法。

语法

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

说明

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

此 cmdlet 直接调用 DSC 资源，而无需创建配置文档。 使用此 cmdlet，配置管理产品可以使用 DSC 资源管理窗口。 当 DSC 引擎或 LCM 在启用调试的情况下运行时，此 cmdlet 还支持对资源进行调试。

示例

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

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

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

示例 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
Type:String
Accepted values:Get, Set, Test
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ModuleName

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

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

-Name

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

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

-Property

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

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

输出

Microsoft.Management.Infrastructure.CimInstance, System.Boolean