Compartilhar via

Invoke-DscResource

  • Referência
Módulo:
PSDesiredStateConfiguration

Executa um método de um recurso de DSC especificado.

Syntax

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

Description

O Invoke-DscResource cmdlet executa um método de um recurso de Windows PowerShell Desired State Configuration (DSC) especificado. Antes de executar esse cmdlet, defina o modo de atualização do LCM (Configuration Manager Local) como Desabilitado.

Esse cmdlet invoca um recurso de DSC diretamente, sem criar um documento de configuração. Usando esse cmdlet, os produtos de gerenciamento de configuração podem gerenciar janelas usando recursos DSC. Esse cmdlet também permite a depuração de recursos quando o mecanismo DSC ou o LCM está em execução com a depuração habilitada.

Esse cmdlet não funciona com recursos compostos. Os recursos compostos são configurações parametrizadas. O uso de recursos compostos requer o LCM.

Exemplos

Exemplo 1: invocar o método Set de um recurso especificando suas propriedades obrigatórias

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

Esse comando invoca o método Set de um recurso chamado Log e especifica uma propriedade Message para ele.

Exemplo 2: Invocar o método Test de um recurso para um módulo especificado

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

Esse comando invoca o método Test de um recurso chamado WindowsProcess, que está no módulo chamado PSDesiredStateConfiguration.

Parâmetros

-Method

Especifica o método do recurso que esse cmdlet invoca. Os valores aceitáveis para esse parâmetro são:

  • 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

Especifica o nome do módulo do qual esse cmdlet invoca o recurso especificado.

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

-Name

Especifica o nome do recurso DSC a ser iniciado.

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

-Property

Especifica o nome da propriedade de recurso e seu valor em uma tabela de hash como chave e valor, respectivamente. Use o Get-DscResource cmdlet para descobrir propriedades de recurso e seus tipos.

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

Saídas

Microsoft.Management.Infrastructure.CimInstance, System.Boolean