Find-Script

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 em repositórios registrados.

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

Exemplos

Exemplo 1: Localizar um script por nome

Find-Script -Name "Start-WFContosoServer"

Esse comando localiza o script chamado Start-WFContosoServer.

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

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

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

Exemplo 3: localizar um script no intervalo de versão 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

Esse comando localiza todas as versões do RequiredScript2 entre as versões 2.1 e 2.5 no repositório LocalRepo1.

Exemplo 4: 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

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

Exemplo 5: Localizar um script e suas 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

Esse comando localiza um script e suas dependências.

Exemplo 6: Localizar scripts com a marca especificada

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

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

Esse comando localiza scripts que têm a marca Tag1 no repositório LocalRepo1

Exemplo 7: Localizar scripts com o nome do 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

Esse comando localiza um script que contém o nome do comando especificado.

Exemplo 8: Localizar scripts usando curingas

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

Esse comando usa o caractere curinga (*) para localizar scripts que começam com Required-Script.

Parâmetros

-AllowPrerelease

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

O cmdlet proxy mapeia esse parâmetro para o parâmetro Prerelease de Find-PSResource.

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

-AllVersions

Indica que essa operação localiza todas as versões de script.

O cmdlet proxy transforma esse parâmetro -Version * em antes de chamar Find-PSResource.

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

-Command

O cmdlet proxy ignora esse parâmetro, pois ele não tem suporte pelo NameParameterSet de Find-PSResource.

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

O cmdlet proxy ignora esse parâmetro, pois ele não tem suporte pelo NameParameterSet de Find-PSResource.

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

-IncludeDependencies

Indica que essa operação obtém todos os scripts que dependem do script especificado no parâmetro Name .

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

-Includes

O cmdlet proxy ignora esse parâmetro, pois ele não tem suporte pelo NameParameterSet de Find-PSResource.

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

-MaximumVersion

O cmdlet proxy usa o valor desse parâmetro para criar uma cadeia de caracteres de pesquisa de versão do NuGet para uso com o parâmetro Version de Find-PSResource.

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

-MinimumVersion

O cmdlet proxy usa o valor desse parâmetro para criar uma cadeia de caracteres de pesquisa de versão do NuGet para uso com o parâmetro Version de Find-PSResource.

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 serem encontrados.

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

-Proxy

O cmdlet proxy ignora esse parâmetro, pois ele não tem suporte pelo NameParameterSet 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 esse parâmetro, pois ele não tem suporte pelo NameParameterSet de Find-PSResource.

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 registrado executando Register-PSRepository.

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

-RequiredVersion

O cmdlet proxy usa o valor desse parâmetro para criar uma cadeia de caracteres de pesquisa de versão do NuGet para uso com o parâmetro Version de Find-PSResource.

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

-Tag

Especifica uma matriz de marcas.

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

Observações

O Galeria do PowerShell não dá mais suporte às versões 1.0 e 1.1 do Protocolo TLS.0 e 1.1. Você deve usar o TLS 1.2 ou superior. Use o seguinte comando para garantir que esteja usando o TLS 1.2:

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

Links Relacionados

• Install-Script
• Publish-Script
• Save-Script
• Uninstall-Script
• Update-Script