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.

Para cada módulo encontrado pelo Find-DscResource, é devolvido um objeto PSGetDscResourceInfo . Os objetos PSGetDscResourceInfo podem ser enviados pelo pipeline para o Install-Module cmdlet . Install-Module instala o módulo.

Exemplos

Exemplo 1: localizar todos os recursos do DSC

Find-DscResource devolve recursos do DSC de repositórios registados. Para procurar um repositório específico, utilize o parâmetro Repositório .

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

Exemplo 2: localizar um recurso do 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 3: localizar um recurso do DSC e instalá-lo

Find-DscResource localiza um recurso do 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.

Exemplo 4: localizar todos os recursos do DSC num módulo

Find-DscResource localiza todos os recursos do DSC contidos num módulo especificado. Por predefinição, é apresentada a versão atual. Para apresentar outras versões, utilize os parâmetros AllVersions ou 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 utiliza o parâmetro ModuleName para especificar a xWebAdministration e encontrar os recursos do DSC contidos no módulo. É apresentada a versão atual de cada recurso.

Exemplo 5: Localizar um recurso do DSC por etiqueta e versão necessária

Os recursos do DSC podem ser localizados com os parâmetros Tag e RequiredVersion. A etiqueta apresenta a versão atual de cada recurso que contém a etiqueta especificada no repositório. RequiredVersion precisa do parâmetro ModuleName e o parâmetro Name é opcional. Os parâmetros Name e ModuleName limitam a saída. Utilize o parâmetro AllVersions para apresentar as versões disponíveis de um recurso do 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

Exemplo 6: localizar um recurso com um filtro

Find-DscResource localiza todos os recursos e utiliza o parâmetro Filter para especificar os resultados por Domínio. O parâmetro Filter localiza o valor do filtro na descrição do objeto ou no nome do módulo. Utilize o Select-Object cmdlet para ver as propriedades de um 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

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

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

-AllVersions

O parâmetro AllVersions apresenta cada uma das versões disponíveis de um recurso do DSC. Não pode utilizar o parâmetro AllVersions com os parâmetros MinimumVersion, MaximumVersion ou RequiredVersion .

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

-Filter

Localiza recursos com base na sintaxe de pesquisa do fornecedor PackageManagement . Por exemplo, especifique palavras a procurar nas propriedades ModuleName e Description .

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

-MaximumVersion

Especifica a versão máxima do recurso a incluir nos resultados. Os parâmetros MaximumVersion e RequiredVersion não podem ser utilizados no mesmo comando.

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

-MinimumVersion

Especifica a versão mínima do recurso a incluir nos resultados. Os parâmetros MinimumVersion e RequiredVersion não podem ser utilizados no mesmo comando.

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

-ModuleName

Especifica um módulo que contém o recurso do DSC.

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 são todos os recursos. Utilize vírgulas para separar uma matriz de nomes de recursos.

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

-Proxy

Especifica um servidor proxy para o pedido, em vez de uma ligação direta ao recurso da Internet.

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

-ProxyCredential

Especifica uma conta de utilizador com permissão para utilizar o servidor proxy especificado no parâmetro Proxy .

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ório.

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

-RequiredVersion

Especifica o número de versão exato do módulo a incluir nos resultados. Os parâmetros RequiredVersion e MinimumVersion não podem ser utilizados no mesmo comando.

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

-Tag

Especifica etiquetas que categorizam módulos num repositório. Utilize vírgulas para separar uma matriz de etiquetas.

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

Importante

A partir de abril de 2020, o Galeria do PowerShell já não suporta as versões 1.0 e 1.1 do Transport Layer Security (TLS). Se não estiver a utilizar o TLS 1.2 ou superior, receberá um erro ao tentar aceder ao Galeria do PowerShell. Utilize o seguinte comando para garantir que está a utilizar o TLS 1.2:

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

Para obter mais informações, veja o anúncio no blogue do PowerShell.

Partilhar via

Find-DscResource

Syntax

Description

Exemplos

Exemplo 1: localizar todos os recursos do DSC

Exemplo 2: localizar um recurso do DSC por nome

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

Exemplo 4: localizar todos os recursos do DSC num módulo

Exemplo 5: Localizar um recurso do DSC por etiqueta e versão necessária

Exemplo 6: localizar um recurso com um filtro

Parâmetros

-AllowPrerelease

-AllVersions

-Filter

-MaximumVersion

-MinimumVersion

-ModuleName

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Tag

Saídas

Notas

Recursos adicionais

Partilhar via

Find-DscResource

Syntax

Description

Exemplos

Exemplo 1: localizar todos os recursos do DSC

Exemplo 2: localizar um recurso do DSC por nome

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

Exemplo 4: localizar todos os recursos do DSC num módulo

Exemplo 5: Localizar um recurso do DSC por etiqueta e versão necessária

Exemplo 6: localizar um recurso com um filtro

Parâmetros

-AllowPrerelease

-AllVersions

-Filter

-MaximumVersion

-MinimumVersion

-ModuleName

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Tag

Saídas

Notas

Ligações Relacionadas

Recursos adicionais