Get-DscResource

  • Referência
Módulo:
PSDesiredStateConfiguration

Obtém recursos de Desired State Configuration (DSC) presentes no computador.

Syntax

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

Description

O Get-DscResource cmdlet recupera os recursos de 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 Name .

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 User e, em seguida, usa o operador de pipeline para retornar todas as propriedades do recurso User.

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.

Type:Object
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

Entradas

String[]

Object

Saídas

Microsoft.PowerShell.DesiredStateConfiguration.DscResourceInfo[]

string[]