Compartilhar via

Get-DscResource

  • Referência
Módulo:
PSDesiredStateConfiguration

Obtém recursos de DSC (Configuração de Estado Desejado) presentes no computador.

Sintaxe

Get-DscResource
   [[-Name] <String[]>]
   [[-Module] <Object>]
   [-Syntax]
   [<CommonParameters>]

Description

O cmdlet Get-DscResource recupera os recursos DSC do PowerShell presentes no computador. Esse cmdlet descobre apenas os recursos instalados no PSModulePath. Ele mostra os detalhes sobre provedores internos e personalizados, que são criados pelo usuário. Esse cmdlet também mostra detalhes sobre recursos compostos, que são outras configurações que são empacotadas como módulo ou criadas em tempo de execução na sessão.

Exemplos

Exemplo 1: Obter todos os recursos no computador local

Get-DscResource

Esse comando obtém todos os recursos no computador local.

Exemplo 2: Obter um recurso especificando o nome

Get-DscResource -Name "WindowsFeature"

Esse comando obtém o recurso WindowsFeature.

Exemplo 3: Obter todos os recursos de um módulo

Get-DscResource -Module "xHyper-V"

Esse comando obtém todos os recursos do módulo xHyper-V.

Exemplo 4: Obter um recurso usando caracteres curinga

Get-DscResource -Name P*,r*

Esse comando obtém todos os recursos que correspondem ao padrão curinga especificado pelo parâmetro nome do.

Exemplo 5: Obter uma sintaxe de recurso

Get-DscResource -Name "WindowsFeature" -Syntax

Esse comando obtém o recurso WindowsFeature e mostra a sintaxe do recurso.

Exemplo 6: Obter todas as propriedades de um recurso

Get-DscResource -Name "User" | Select-Object -ExpandProperty Properties

Esse comando obtém o recurso usuário e usa o operador de pipeline para retornar todas as propriedades do recurso usuário.

Exemplo 7: Obter todos os recursos de um módulo especificado com uma versão especificada

Get-DscResource -Module @{ModuleName='xHyper-V';RequiredVersion='3.0.0.0'}

Esse comando obtém todos os recursos do módulo xHyper-V com a versão 3.0.0.0.

Parâmetros

-Module

Especifica o nome ou o nome totalmente qualificado do módulo para o qual exibir o recurso DSC.

Tipo:Object
Cargo:1
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

Especifica uma matriz de nomes do recurso DSC a ser exibido.

Tipo:String[]
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Syntax

Indica que o cmdlet retorna a exibição de sintaxe dos recursos de DSC especificados. A sintaxe retornada mostra como usar os recursos em um script do PowerShell.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

String[]

Object

Saídas

Microsoft.PowerShell.DesiredStateConfiguration.DscResourceInfo[]

string[]