Partilhar via

Get-DscResource

  • Referência
Módulo:
PSDesiredStateConfiguration

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

Syntax

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

Description

O Get-DscResource cmdlet obtém os recursos do DSC do PowerShell presentes no computador. Este cmdlet deteta apenas os recursos instalados no PSModulePath. Mostra os detalhes sobre fornecedores incorporados e personalizados, que são criados pelo utilizador. Este cmdlet também mostra detalhes sobre recursos compostos, que são outras configurações que são empacotadas como módulo ou criadas no tempo de execução na sessão.

Exemplos

Exemplo 1: Obter todos os recursos no computador local

Get-DscResource

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

Exemplo 2: Obter um recurso ao especificar o nome

Get-DscResource -Name "WindowsFeature"

Este comando obtém o recurso WindowsFeature.

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

Get-DscResource -Module "xHyper-V"

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

Exemplo 4: Obter um recurso com carateres universais

Get-DscResource -Name P*,r*

Este comando obtém todos os recursos que correspondem ao padrão universal especificado pelo parâmetro Nome .

Exemplo 5: Obter uma sintaxe de recurso

Get-DscResource -Name "WindowsFeature" -Syntax

Este 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

Este comando obtém o recurso Utilizador e, em seguida, utiliza o operador de pipeline para devolver todas as propriedades do recurso Utilizador.

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'}

Este 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 completamente qualificado do módulo para o qual pode ver o recurso do 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 ver.

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

-Syntax

Indica que o cmdlet devolve a vista de sintaxe dos recursos de DSC especificados. A sintaxe devolvida mostra como utilizar os recursos num 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[]