共用方式為

Invoke-DscResource

  • 參考
模組:
PSDesiredStateConfiguration

執行指定 DSC 資源的方法。

Syntax

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

Description

Cmdlet 會Invoke-DscResource執行指定 Windows PowerShell Desired State Configuration (DSC) 資源的方法。 執行此 Cmdlet 之前，請將 [本機 Configuration Manager (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 方法，併為其指定 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