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.

Se trata de un cmdlet de proxy para el Find-PSResource cmdlet en Microsoft.PowerShell.PSResourceGet. Para obtener más información, consulte Find-PSResource.

Ejemplos

Ejemplo 1: Buscar un recurso de DSC por nombre

Find-DscResource busca 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 2: 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 por la canalización al Install-Module cmdlet . Install-Module instala el módulo xWebAdministration para el recurso.

Parámetros

-AllowPrerelease

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

El cmdlet de proxy asigna este parámetro al parámetro versión preliminar de Find-PSResource.

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

-AllVersions

El cmdlet proxy omite este parámetro, ya que no es compatible con DscResourceNameParameterSet de Find-PSResource.

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

-Filter

El cmdlet proxy omite este parámetro, ya que no es compatible con DscResourceNameParameterSet de Find-PSResource.

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

-MaximumVersion

El cmdlet proxy omite este parámetro, ya que no es compatible con DscResourceNameParameterSet de Find-PSResource.

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

-MinimumVersion

El cmdlet proxy omite este parámetro, ya que no es compatible con DscResourceNameParameterSet de Find-PSResource.

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

-ModuleName

El cmdlet proxy omite este parámetro, ya que no es compatible con DscResourceNameParameterSet de Find-PSResource.

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.

El cmdlet proxy asigna este parámetro al parámetro DscResourceName de Find-PSResource.

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

-Proxy

El cmdlet proxy omite este parámetro, ya que no es compatible con DscResourceNameParameterSet de Find-PSResource.

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

-ProxyCredential

El cmdlet proxy omite este parámetro, ya que no es compatible con DscResourceNameParameterSet de Find-PSResource.

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

El cmdlet proxy omite este parámetro, ya que no es compatible con DscResourceNameParameterSet de Find-PSResource.

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

-Tag

El cmdlet proxy omite este parámetro, ya que no es compatible con DscResourceNameParameterSet de Find-PSResource.

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

El Galería de PowerShell ya no admite las versiones 1.0 y 1.1 de Seguridad de la capa de transporte (TLS). Debe usar TLS 1.2 o superior. Use el siguiente comando para asegurarse de que usa TLS 1.2:

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