Share via

Find-DscResource

  • Referência
Módulo:
PowerShellGet

Localiza recursos 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

O Find-DscResource cmdlet procura repositórios registados para encontrar recursos do DSC contidos em módulos. Por predefinição Find-DscResource , procura todos os repositórios registados.

Este é um cmdlet proxy para o Find-PSResource cmdlet no Microsoft.PowerShell.PSResourceGet. Para obter mais informações, veja Find-PSResource.

Exemplos

Exemplo 1: Localizar um recurso DSC por nome

Find-DscResource localiza os recursos do DSC por nome. Utilize vírgulas para separar uma matriz de nomes 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 utiliza o parâmetro Nome para localizar a matriz especificada de recursos do DSC.

Exemplo 2: localizar um recurso do DSC e instalá-lo

Find-DscResource localiza um recurso DSC e envia o objeto pelo pipeline para ser instalado. Após a instalação, utilize Get-InstalledModule para ver os resultados.

Vários recursos do mesmo módulo podem ser enviados pelo pipeline para o Install-Module. Install-Module tenta instalar apenas o módulo uma vez.

Find-DscResource -Name xWebsite | Install-Module

Find-DscResource utiliza o parâmetro Nome para localizar o recurso com o nome xWebsite. O objeto é enviado pelo pipeline para o Install-Module cmdlet. Install-Module instala o módulo xWebAdministration para o recurso.

Parâmetros

-AllowPrerelease

Inclui recursos marcados como pré-lançamento nos resultados.

O cmdlet proxy mapeia este parâmetro para o parâmetro Pré-lançamento de Find-PSResource.

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

-AllVersions

O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo DscResourceNameParameterSet de Find-PSResource.

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

-Filter

O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo DscResourceNameParameterSet de Find-PSResource.

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

-MaximumVersion

O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo DscResourceNameParameterSet de Find-PSResource.

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

-MinimumVersion

O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo DscResourceNameParameterSet de Find-PSResource.

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

-ModuleName

O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo DscResourceNameParameterSet de Find-PSResource.

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

-Name

Especifica o nome de um recurso. A predefinição é todos os recursos. Utilize vírgulas para separar uma matriz de nomes de recursos.

O cmdlet proxy mapeia este parâmetro para o parâmetro DscResourceName de Find-PSResource.

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

-Proxy

O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo DscResourceNameParameterSet de Find-PSResource.

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

-ProxyCredential

O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo DscResourceNameParameterSet de Find-PSResource.

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

-Repository

Especifica um repositório para procurar recursos. Utilize vírgulas para separar uma matriz de nomes de repositórios.

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

-RequiredVersion

O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo DscResourceNameParameterSet de Find-PSResource.

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

-Tag

O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo DscResourceNameParameterSet de Find-PSResource.

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

Saídas

PSGetDscResourceInfo

Find-DscResource devolve um objeto PSGetDscResourceInfo .

Notas

O Galeria do PowerShell já não suporta as versões 1.0 e 1.1 do Transport Layer Security (TLS). Tem de utilizar o TLS 1.2 ou superior. Utilize o seguinte comando para garantir que está a utilizar o TLS 1.2:

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