Get-DscResource

  • Referencia
Módulo:
PSDesiredStateConfiguration

Obtiene Desired State Configuration (DSC) recursos presentes en el equipo.

Syntax

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

Description

El Get-DscResource cmdlet recupera los recursos de DSC de PowerShell presentes en el equipo. Este cmdlet detecta solo los recursos instalados en PSModulePath. Muestra los detalles sobre los proveedores integrados y personalizados, creados por el usuario. Este cmdlet también muestra detalles sobre los recursos compuestos, que son otras configuraciones empaquetadas como módulos o creadas en tiempo de ejecución en la sesión.

Ejemplos

Ejemplo 1: Obtención de todos los recursos en el equipo local

Get-DscResource

Este comando obtiene todos los recursos del equipo local.

Ejemplo 2: Obtener un recurso especificando el nombre

Get-DscResource -Name "WindowsFeature"

Este comando obtiene el recurso WindowsFeature.

Ejemplo 3: Obtención de todos los recursos de un módulo

Get-DscResource -Module "xHyper-V"

Este comando obtiene todos los recursos del módulo xHyper-V.

Ejemplo 4: Obtención de un recurso mediante caracteres comodín

Get-DscResource -Name P*,r*

Este comando obtiene todos los recursos que coinciden con el patrón de caracteres comodín especificado por el parámetro Name .

Ejemplo 5: Obtención de una sintaxis de recursos

Get-DscResource -Name "WindowsFeature" -Syntax

Este comando obtiene el recurso WindowsFeature y muestra la sintaxis del recurso.

Ejemplo 6: Obtención de todas las propiedades de un recurso

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

Este comando obtiene el recurso User y, después, utiliza el operador de canalización para devolver todas las propiedades del recurso User.

Ejemplo 7: Obtener todos los recursos de un módulo especificado con una versión especificada

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

Este comando obtiene todos los recursos del módulo xHyper-V con la versión 3.0.0.0.

Parámetros

-Module

Especifica el nombre o el nombre completo del módulo para el que se va a ver el recurso de DSC.

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

-Name

Especifica una matriz de nombres del recurso de DSC que se va a ver.

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

-Syntax

Indica que el cmdlet devuelve la vista de sintaxis de los recursos de DSC especificados. La sintaxis devuelta muestra cómo usar los recursos en un script de PowerShell.

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

Entradas

String[]

Object

Salidas

Microsoft.PowerShell.DesiredStateConfiguration.DscResourceInfo[]

string[]