Partilhar via


Invoke-DscResource

Executa um método de um recurso 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 este cmdlet, defina o modo de atualização do Configuration Manager Local (LCM) como Desativado.

Este cmdlet invoca um recurso do DSC diretamente, sem criar um documento de configuração. Com este cmdlet, os produtos de gestão de configuração podem gerir janelas com recursos DSC. Este cmdlet também permite a depuração de recursos quando o motor DSC ou LCM está em execução com a depuração ativada.

Este cmdlet não funciona com recursos compostos. Os recursos compostos são configurações parametrizadas. A utilização de recursos compostos requer o LCM.

Exemplos

Exemplo 1: Invocar o método Definir de um recurso ao especificar as respetivas propriedades obrigatórias

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

Este comando invoca o método Definir de um recurso denominado Registo e especifica uma propriedade Mensagem para o mesmo.

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

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

Parâmetros

-Method

Especifica o método do recurso que este cmdlet invoca. Os valores aceitáveis para este 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 a partir do qual este 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 iniciar.

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 o respetivo valor numa tabela hash como chave e valor, respetivamente. Utilize o Get-DscResource cmdlet para detetar as propriedades dos recursos e os respetivos 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