Compartir a través de

Get-DscResource

  • Referencia
Módulo:
PSDesiredStateConfiguration

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

Sintaxis

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

Description

El cmdlet Get-DscResource 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 que se empaquetan como módulo o se crean 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, a continuación, usa 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.

Tipo:Object
Posición:1
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

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

Tipo:String[]
Posición:0
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String[]

Object

Salidas

Microsoft.PowerShell.DesiredStateConfiguration.DscResourceInfo[]

string[]