Find-Script

Referência

Módulo:: PowerShellGet

Localiza um script.

Syntax

Find-Script
    [[-Name] <String[]>]
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-AllVersions]
    [-IncludeDependencies]
    [-Filter <String>]
    [-Tag <String[]>]
    [-Includes <String[]>]
    [-Command <String[]>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [-AllowPrerelease]
    [<CommonParameters>]

Description

O Find-Script cmdlet localiza um script especificado nos repositórios registados.

Exemplos

Exemplo 1: localizar todos os scripts disponíveis

Find-Script

Este comando localiza todos os scripts disponíveis.

Exemplo 2: localizar um script por nome

Find-Script -Name "Start-WFContosoServer"

Este comando localiza o script com o nome Start-WFContosoServer.

Exemplo 3: localizar um script por nome, versão necessária e a partir de um repositório especificado

Find-Script -Name "Required-Script2" -RequiredVersion 2.0 -Repository "LocalRepo01"

Este comando localiza um script por nome e versão necessária no repositório LocalRepo01.

Exemplo 4: localizar um script e formatar a saída como uma lista

Find-Script -Name "Required-Script2" -RequiredVersion 2.0 -Repository "LocalRepo1" | Format-List * -Force

Este comando localiza Required-Script2 no repositório LocalRepo1 e, em seguida, transmite o objeto PSRepositoryItemInfo resultante para o Format-List cmdlet .

Exemplo 5: localizar um script no intervalo de versões especificado

Find-Script -Name "Required-Script2" -MinimumVersion 2.1 -MaximumVersion 2.5 -Repository "LocalRepo1"
Version    Name                                Type       Repository           Description
-------    ----                                ----       ----------           -----------
2.5        Required-Script2                    Script     LocalRepo1           Description for the Required-Script2 script

Este comando localiza todas as versões de RequiredScript2 entre as versões 2.1 e 2.5 no respositório LocalRepo1.

Exemplo 6: localizar todas as versões de um script

Find-Script -Name "Required-Script02" -AllVersions

Version    Name                                Type       Repository           Description
-------    ----                                ----       ----------           -----------
1.0        Required-Script2                    Script     LocalRepo1           Description for the Required-Script2 script
1.5        Required-Script2                    Script     LocalRepo1           Description for the Required-Script2 script
2.0        Required-Script2                    Script     LocalRepo1           Description for the Required-Script2 script
2.5        Required-Script2                    Script     LocalRepo1           Description for the Required-Script2 script

Este comando localiza todas as versões de Required-Script02.

Exemplo 7: localizar um script e as respetivas dependências

Find-Script -Name "Script-WithDependencies1" -IncludeDependencies -Repository "LocalRepo1"

Version    Name                                Type       Repository           Description
-------    ----                                ----       ----------           -----------
1.0        Script-WithDependencies1            Script     LocalRepo1           Description for the Script-WithDependencies1 script
2.0        RequiredModule3                     Script     LocalRepo1           RequiredModule3 module
2.5        Required-Script1                    Script     LocalRepo1           Description for the Required-Script1 script
2.5        Required-Script2                    Script     LocalRepo1           Description for the Required-Script2 script

Este comando localiza um script e as respetivas dependências.

Exemplo 8: localizar scripts com a etiqueta especificada

Find-Script -Tag "Tag1" -Repository "LocalRepo1"

Version    Name                                Type       Repository           Description
-------    ----                                ----       ----------           -----------
1.0        Fabrikam-ClientScript               Script     LocalRepo1           Description for the Fabrikam-ClientScript script

Este comando localiza scripts que têm a etiqueta Tag1 no repositório LocalRepo1

Exemplo 9: localizar scripts com o nome de comando especificado

Find-Script -Command Test-FunctionFromScript_Required-Script3 -Repository "LocalRepo1"

Version    Name                                Type       Repository           Description
-------    ----                                ----       ----------           -----------
2.5        Required-Script3                    Script     LocalRepo1           Description for the Required-Script3 script

Este comando localiza um script que contém o nome de comando especificado.

Exemplo 10: localizar scripts com fluxos de trabalho

Find-Script -Includes "Workflow" -Repository "LocalRepo1"

Version    Name                                Type       Repository           Description
-------    ----                                ----       ----------           -----------
2.5        Fabrikam-ClientScript               Script     LocalRepo1           Description for the Fabrikam-ClientScript script
1.0        Fabrikam-Script                     Script     LocalRepo1           Description for the Fabrikam-Script script

Este comando localiza scripts de fluxo de trabalho no repositório LocalRepo1.

Exemplo 11: localizar scripts com carateres universais

Find-Script -Name "Required-Script*" -Repository "LocalRepo1"
Version    Name                                Type       Repository           Description
-------    ----                                ----       ----------           -----------
2.5        Required-Script1                    Script     local1               Description for the Required-Script1 script
2.5        Required-Script2                    Script     local1               Description for the Required-Script2 script
2.5        Required-Script3                    Script     local1               Description for the Required-Script3 script

Este comando utiliza o caráter universal (*) para localizar scripts que comecem por Required-Script.

Parâmetros

-AllowPrerelease

Inclui os scripts de resultados marcados como pré-lançamento.

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

-AllVersions

Indica que esta operação localiza todas as versões do script.

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

-Command

Especifica uma matriz de comandos a localizar em scripts. Um comando pode ser uma função ou fluxo de trabalho.

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

-Credential

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

-Filter

Localiza scripts com base na sintaxe de pesquisa específica do fornecedor PackageManagement .

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

-IncludeDependencies

Indica que esta operação obtém todos os scripts dependentes do script especificado no parâmetro Nome .

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

-Includes

Especifica o tipo de script a obter. Os valores aceitáveis para este parâmetro são:

Function
Workflow

Type:	String[]
Accepted values:	Function, Workflow
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaximumVersion

Especifica a versão máxima ou mais recente do script a localizar. Os parâmetros MaximumVersion e RequiredVersion são mutuamente exclusivos; não pode utilizar ambos os parâmetros no mesmo comando.

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

-MinimumVersion

Especifica a versão mínima do script a localizar. Os parâmetros MinimumVersion e RequiredVersion são mutuamente exclusivos; não pode utilizar ambos os parâmetros no mesmo comando.

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

-Name

Especifica uma matriz de nomes de scripts a localizar.

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

-Proxy

Especifica um servidor proxy para o pedido, em vez de ligar diretamente 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 que tem permissão para utilizar o servidor proxy especificado pelo parâmetro Proxy .

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

-Repository

Especifica o nome amigável de um repositório que foi registado ao executar Register-PSRepository.

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

-RequiredVersion

Especifica o número exato da versão do script a localizar.

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

-Tag

Especifica uma matriz de etiquetas.

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

Entradas

String[]

String

Uri

PSCredential

Saídas

PSRepositoryItemInfo

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-Script

Syntax

Description

Exemplos

Exemplo 1: localizar todos os scripts disponíveis

Exemplo 2: localizar um script por nome

Exemplo 3: localizar um script por nome, versão necessária e a partir de um repositório especificado

Exemplo 4: localizar um script e formatar a saída como uma lista

Exemplo 5: localizar um script no intervalo de versões especificado

Exemplo 6: localizar todas as versões de um script

Exemplo 7: localizar um script e as respetivas dependências

Exemplo 8: localizar scripts com a etiqueta especificada

Exemplo 9: localizar scripts com o nome de comando especificado

Exemplo 10: localizar scripts com fluxos de trabalho

Exemplo 11: localizar scripts com carateres universais

Parâmetros

-AllowPrerelease

-AllVersions

-Command

-Credential

-Filter

-IncludeDependencies

-Includes

-MaximumVersion

-MinimumVersion

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Tag

Entradas

Saídas

Notas

Recursos adicionais

Partilhar via

Find-Script

Syntax

Description

Exemplos

Exemplo 1: localizar todos os scripts disponíveis

Exemplo 2: localizar um script por nome

Exemplo 3: localizar um script por nome, versão necessária e a partir de um repositório especificado

Exemplo 4: localizar um script e formatar a saída como uma lista

Exemplo 5: localizar um script no intervalo de versões especificado

Exemplo 6: localizar todas as versões de um script

Exemplo 7: localizar um script e as respetivas dependências

Exemplo 8: localizar scripts com a etiqueta especificada

Exemplo 9: localizar scripts com o nome de comando especificado

Exemplo 10: localizar scripts com fluxos de trabalho

Exemplo 11: localizar scripts com carateres universais

Parâmetros

-AllowPrerelease

-AllVersions

-Command

-Credential

-Filter

-IncludeDependencies

-Includes

-MaximumVersion

-MinimumVersion

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Tag

Entradas

Saídas

Notas

Ligações Relacionadas

Recursos adicionais