Find-Script

Módulo:

PowerShellGet

Busca un 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

El Find-Script cmdlet busca un script especificado en repositorios registrados.

Ejemplos

Ejemplo 1: Búsqueda de todos los scripts disponibles

Find-Script

Este comando busca todos los scripts disponibles.

Ejemplo 2: Buscar un script por nombre

Find-Script -Name "Start-WFContosoServer"

Este comando busca el script denominado Start-WFContosoServer.

Ejemplo 3: Búsqueda de un script por nombre, versión necesaria y desde un repositorio especificado

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

Este comando busca un script por nombre y la versión necesaria en el repositorio LocalRepo01.

Ejemplo 4: Buscar un script y dar formato a la salida como una lista

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

Este comando busca Required-Script2 en el repositorio LocalRepo1 y, a continuación, pasa el objeto PSRepositoryItemInfo resultante al Format-List cmdlet .

Ejemplo 5: Buscar un script en el intervalo de versiones 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 busca todas las versiones de RequiredScript2 entre las versiones 2.1 y 2.5 en el respository localRepo1.

Ejemplo 6: Búsqueda de todas las versiones de un 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 busca todas las versiones de Required-Script02.

Ejemplo 7: Búsqueda de un script y sus dependencias

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 busca un script y sus dependencias.

Ejemplo 8: Búsqueda de scripts con la 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 busca scripts que tienen la etiqueta Tag1 en el repositorio LocalRepo1.

Ejemplo 9: Búsqueda de scripts con el nombre 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 busca un script que contiene el nombre de comando especificado.

Ejemplo 10: Búsqueda de scripts con flujos de trabajo

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 busca scripts de flujo de trabajo en el repositorio LocalRepo1.

Ejemplo 11: Búsqueda de scripts mediante caracteres comodín

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 usa el carácter comodín (*) para buscar scripts que comiencen por Required-Script.

Parámetros

-AllowPrerelease

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

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

-AllVersions

Indica que esta operación busca todas las versiones de script.

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

-Command

Especifica una matriz de comandos que se van a buscar en scripts. Un comando puede ser una función o un flujo de trabajo.

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

Busca scripts basados en la sintaxis de búsqueda específica del proveedor PackageManagement .

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

-IncludeDependencies

Indica que esta operación obtiene todos los scripts que dependen del script especificado en el parámetro Name .

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

-Includes

Especifica el tipo de script que se va a obtener. Los valores permitidos para este parámetro son los siguientes:

• 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 la versión máxima o más reciente del script que se va a buscar. Los parámetros MaximumVersion y RequiredVersion son mutuamente excluyentes; No puede usar ambos parámetros en el mismo comando.

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

-MinimumVersion

Especifica la versión mínima del script que se va a buscar. Los parámetros MinimumVersion y RequiredVersion son mutuamente excluyentes; No puede usar ambos parámetros en el mismo comando.

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

-Name

Especifica una matriz de nombres de scripts que se van a buscar.

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

-Proxy

Especifica un servidor proxy para la solicitud, en lugar de conectarse directamente al recurso de Internet.

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

-ProxyCredential

Especifica una cuenta de usuario que tiene permiso para usar el servidor proxy especificado por el parámetro Proxy.

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

-Repository

Especifica el nombre descriptivo de un repositorio que se ha registrado mediante la ejecución Register-PSRepositoryde .

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

-RequiredVersion

Especifica el número de versión exacto del script que se va a buscar.

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

-Tag

Especifica una 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

Salidas

PSRepositoryItemInfo

Notas

Importante

A partir de abril de 2020, Galería de PowerShell ya no es compatible con las versiones 1.0 y 1.1 de Seguridad de la capa de transporte (TLS). Si no usa TLS 1.2 o una versión posterior, recibirá un error al intentar obtener acceso a Galería de PowerShell. Use el siguiente comando para asegurarse de que usa TLS 1.2:

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

Para más información, consulte el anuncio en el blog de PowerShell.

Vínculos relacionados

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