Find-Script

  • Referencia
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.

Se trata de un cmdlet de proxy para el Find-PSResource cmdlet en Microsoft.PowerShell.PSResourceGet. Para obtener más información, consulte Find-PSResource.

Ejemplos

Ejemplo 1: Buscar un script por nombre

Find-Script -Name "Start-WFContosoServer"

Este comando busca el script denominado Start-WFContosoServer.

Ejemplo 2: 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 3: 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 4: 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 5: 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 6: 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 7: 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 8: 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.

El cmdlet de proxy asigna este parámetro al parámetro Versión preliminar de Find-PSResource.

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.

El cmdlet de proxy transforma este parámetro -Version * en antes de llamar a Find-PSResource.

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

-Command

El cmdlet de proxy omite este parámetro, ya que no es compatible con 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

El cmdlet de proxy omite este parámetro, ya que no es compatible con NameParameterSet de Find-PSResource.

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

El cmdlet de proxy omite este parámetro, ya que no es compatible con 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

El cmdlet de proxy usa el valor de este parámetro para crear una cadena de búsqueda de versión de NuGet para usarla con el parámetro Version de Find-PSResource.

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

-MinimumVersion

El cmdlet de proxy usa el valor de este parámetro para crear una cadena de búsqueda de versión de NuGet para usarla con el 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 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

El cmdlet de proxy omite este parámetro, ya que no es compatible con NameParameterSet de Find-PSResource.

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

-ProxyCredential

El cmdlet de proxy omite este parámetro, ya que no es compatible con NameParameterSet de Find-PSResource.

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

El cmdlet de proxy usa el valor de este parámetro para crear una cadena de búsqueda de versión de NuGet para usarla con el 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 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

El Galería de PowerShell ya no admite las versiones 1.0 y 1.1 de Seguridad de la capa de transporte (TLS). Debe usar TLS 1.2 o superior. Use el siguiente comando para asegurarse de que usa TLS 1.2:

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