Compartir a través de

Find-DscResource

  • Referencia
Módulo:
PowerShellGet

Busca recursos de Desired State Configuration (DSC).

Syntax

Find-DscResource
    [[-Name] <String[]>]
    [-ModuleName <String>]
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-AllVersions]
    [-AllowPrerelease]
    [-Tag <String[]>]
    [-Filter <String>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Repository <String[]>]
    [<CommonParameters>]

Description

El Find-DscResource cmdlet busca repositorios registrados para buscar recursos de DSC contenidos en módulos. De forma predeterminada Find-DscResource , busca en todos los repositorios registrados.

Para cada módulo encontrado por Find-DscResource, se devuelve un objeto PSGetDscResourceInfo . Los objetos PSGetDscResourceInfo se pueden enviar a la canalización al Install-Module cmdlet . Install-Module instala el módulo.

Ejemplos

Ejemplo 1: Búsqueda de todos los recursos de DSC

Find-DscResource devuelve recursos de DSC de repositorios registrados. Para buscar en un repositorio específico, use el parámetro Repository .

Find-DscResource

Name                           Version    ModuleName                     Repository
----                           -------    ----------                     ----------
Carbon_Privilege               2.8.1      Carbon                         PSGallery
Carbon_ScheduledTask           2.8.1      Carbon                         PSGallery
Carbon_Service                 2.8.1      Carbon                         PSGallery
PackageManagement              1.4        PackageManagement              PSGallery
PackageManagementSource        1.4        PackageManagement              PSGallery
PSModule                       2.1.4      PowerShellGet                  PSGallery
PSRepository                   2.1.4      PowerShellGet                  PSGallery
xArchive                       8.7.0.0    xPSDesiredStateConfiguration   PSGallery
xDSCWebService                 8.7.0.0    xPSDesiredStateConfiguration   PSGallery
xEnvironment                   8.7.0.0    xPSDesiredStateConfiguration   PSGallery

Ejemplo 2: Búsqueda de un recurso de DSC por nombre

Find-DscResource localiza los recursos de DSC por nombre. Use comas para separar una matriz de nombres de recursos.

Find-DscResource -Name xWebsite, xWebApplication, xWebSiteDefaults

Name               Version    ModuleName            Repository
----               -------    ----------            ----------
xWebApplication    2.6.0.0    xWebAdministration    PSGallery
xWebsite           2.6.0.0    xWebAdministration    PSGallery
xWebSiteDefaults   2.6.0.0    xWebAdministration    PSGallery

Find-DscResource usa el parámetro Name para buscar la matriz especificada de recursos de DSC.

Ejemplo 3: Buscar un recurso de DSC e instalarlo

Find-DscResource busca un recurso de DSC y envía el objeto a la canalización que se va a instalar. Después de la instalación, use Get-InstalledModule para ver los resultados.

Se pueden enviar varios recursos del mismo módulo a la Install-Modulecanalización . Install-Module intenta instalar solo el módulo una vez.

Find-DscResource -Name xWebsite | Install-Module

Find-DscResource usa el parámetro Name para buscar el recurso denominado xWebsite. El objeto se envía a la canalización al Install-Module cmdlet . Install-Module instala el módulo xWebAdministration para el recurso.

Ejemplo 4: Búsqueda de todos los recursos de DSC en un módulo

Find-DscResource busca todos los recursos de DSC contenidos en un módulo especificado. De forma predeterminada, se muestra la versión actual. Para mostrar otras versiones, use los parámetros AllVersions o RequiredVersions .

Find-DscResource -ModuleName xWebAdministration

Name                                Version    ModuleName              Repository
----                                -------    ----------              ----------
WebApplicationHandler               2.6.0.0    xWebAdministration      PSGallery
xIisFeatureDelegation               2.6.0.0    xWebAdministration      PSGallery
xIisHandler                         2.6.0.0    xWebAdministration      PSGallery
xIisLogging                         2.6.0.0    xWebAdministration      PSGallery

Find-DscResource usa el parámetro ModuleName para especificar xWebAdministration y buscar los recursos de DSC contenidos en el módulo. Se muestra la versión actual de cada recurso.

Ejemplo 5: Búsqueda de un recurso de DSC por etiqueta y versión necesaria

Los recursos de DSC se pueden encontrar mediante los parámetros Tag y RequiredVersion. Etiqueta muestra la versión actual de cada recurso que contiene la etiqueta especificada en el repositorio. RequiredVersion necesita el parámetro ModuleName y el parámetro Name es opcional. Los parámetros Name y ModuleName limitan la salida. Use el parámetro AllVersions para mostrar las versiones disponibles de un recurso de DSC.

Find-DscResource -ModuleName xWebAdministration -Tag DSC -RequiredVersion 1.20

Name                    Version    ModuleName             Repository
----                    -------    ----------             ----------
xIisFeatureDelegation   1.20.0.0   xWebAdministration     PSGallery
xIisHandler             1.20.0.0   xWebAdministration     PSGallery
xIisLogging             1.20.0.0   xWebAdministration     PSGallery
xIisMimeTypeMapping     1.20.0.0   xWebAdministration     PSGallery

Ejemplo 6: Búsqueda de un recurso mediante un filtro

Find-DscResource busca todos los recursos y usa el parámetro Filter para especificar los resultados por Dominio. El parámetro Filter busca el valor de filtro en la descripción o el nombre del módulo del objeto. Use el cmdlet para ver las Select-Object propiedades de un objeto.

Find-DscResource -Filter Domain

Name                    Version    ModuleName                 Repository
----                    -------    ----------                 ---------
xComputer               4.1.0.0    xComputerManagement        PSGallery
Computer                6.4.0.0    ComputerManagementDsc      PSGallery
xDSCDomainjoin          1.1        xDSCDomainjoin             PSGallery
xDisk                   1.0        xDisk                      PSGallery
xDSCFirewall            1.6.21     xDSCFirewall               PSGallery
dmAwsTagInstance        1.0.1      domainAwsDSCResources      PSGallery

Parámetros

-AllowPrerelease

Incluye recursos marcados como una versión preliminar en los resultados.

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

-AllVersions

El parámetro AllVersions muestra cada una de las versiones disponibles de un recurso de DSC. No puede usar el parámetro AllVersions con los parámetros MinimumVersion, MaximumVersion o RequiredVersion .

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

-Filter

Busca recursos basados en la sintaxis de búsqueda del proveedor PackageManagement . Por ejemplo, especifique las palabras que se van a buscar en las propiedades ModuleName y Description .

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

-MaximumVersion

Especifica la versión máxima del recurso que se va a incluir en los resultados. Los parámetros MaximumVersion y RequiredVersion no se pueden usar en el mismo comando.

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

-MinimumVersion

Especifica la versión mínima del recurso que se va a incluir en los resultados. Los parámetros MinimumVersion y RequiredVersion no se pueden usar en el mismo comando.

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

-ModuleName

Especifica un módulo que contiene el recurso de DSC.

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

-Name

Especifica el nombre de un recurso. El valor predeterminado es todos los recursos. Use comas para separar una matriz de nombres de recursos.

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

-Proxy

Especifica un servidor proxy para la solicitud, en lugar de una conexión directa al recurso de Internet.

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

-ProxyCredential

Especifica una cuenta de usuario con permiso para usar el servidor proxy especificado en el parámetro Proxy .

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

-Repository

Especifica un repositorio para buscar recursos. Use comas para separar una matriz de nombres de repositorio.

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

-RequiredVersion

Especifica el número de versión exacto del módulo que se va a incluir en los resultados. Los parámetros RequiredVersion y MinimumVersion no se pueden usar en el mismo comando.

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

-Tag

Especifica etiquetas que clasifican módulos en un repositorio. Use comas para separar una matriz de etiquetas.

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

Salidas

PSGetDscResourceInfo

Find-DscResource devuelve un objeto PSGetDscResourceInfo .

Notas

Importante

A partir de abril de 2020, Galería de PowerShell ya no es compatible con las versiones 1.0 y 1.1 de Seguridad de la capa de transporte (TLS). Si no usa TLS 1.2 o una versión posterior, recibirá un error al intentar obtener acceso a Galería de PowerShell. Use el siguiente comando para asegurarse de que usa TLS 1.2:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Para más información, consulte el anuncio en el blog de PowerShell.