Get-DscResource
Obtiene los recursos de Desired State Configuration (DSC) presentes en el equipo.
Sintaxis
Default (Es el valor predeterminado).
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.
Propiedades del parámetro
| Tipo: | Object |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 1 |
| Mandatory: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Name
Especifica una matriz de nombres del recurso de DSC que se va a ver.
Propiedades del parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 0 |
| Mandatory: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | 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.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
