Find-Package

Referencia

Módulo:: PackageManagement

Busca paquetes de software en los orígenes de paquetes disponibles.

Syntax

Find-Package
    [-IncludeDependencies]
    [-AllVersions]
    [-Source <String[]>]
    [-Credential <PSCredential>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [[-Name] <String[]>]
    [-RequiredVersion <String>]
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-Force]
    [-ForceBootstrap]
    [-ProviderName <String[]>]
    [-ConfigFile <String>]
    [-SkipValidate]
    [-Headers <String[]>]
    [-FilterOnTag <String[]>]
    [-Contains <String>]
    [-AllowPrereleaseVersions]
    [<CommonParameters>]

Find-Package
    [-IncludeDependencies]
    [-AllVersions]
    [-Source <String[]>]
    [-Credential <PSCredential>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [[-Name] <String[]>]
    [-RequiredVersion <String>]
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-Force]
    [-ForceBootstrap]
    [-ProviderName <String[]>]
    [-AllowPrereleaseVersions]
    [-PackageManagementProvider <String>]
    [-PublishLocation <String>]
    [-ScriptSourceLocation <String>]
    [-ScriptPublishLocation <String>]
    [-Type <String>]
    [-Filter <String>]
    [-Tag <String[]>]
    [-Includes <String[]>]
    [-DscResource <String[]>]
    [-RoleCapability <String[]>]
    [-Command <String[]>]
    [-AcceptLicense]
    [<CommonParameters>]

Description

Find-Package busca paquetes de software que están disponibles en los orígenes de paquetes. Get-PackageProvider y Get-PackageSource muestran detalles sobre los proveedores.

Importante

Los comandos contenidos en el módulo PackageManagement son diferentes de los que proporciona el módulo NuGet en la consola del Administrador de paquetes de Visual Studio. Cada módulo tiene comandos que no están disponibles en el otro. Los comandos con el mismo nombre difieren en sus argumentos específicos. Para obtener más información, consulte la documentación de referencia de PowerShell para la consola del Administrador de paquetes de Visual Studio.

Ejemplos

Ejemplo 1: Buscar todos los paquetes disponibles de un proveedor de paquetes

Este comando busca todos los paquetes de módulos de PowerShell disponibles en una galería registrada. Use Get-PackageProvider para obtener el nombre del proveedor.

Find-Package -ProviderName NuGet

Name               Version   Source     Summary
----               -------   ------     -------
NUnit              3.11.0    MyNuGet    NUnit is a unit-testing framework for all .NET langua...
Newtonsoft.Json    12.0.1    MyNuGet    Json.NET is a popular high-performance JSON framework...
EntityFramework    6.2.0     MyNuGet    Entity Framework is Microsoft's recommended data acce...
MySql.Data         8.0.15    MyNuGet    MySql.Data.MySqlClient .Net Core Class Library
bootstrap          4.3.1     MyNuGet    Bootstrap framework in CSS. Includes fonts and JavaSc...
NuGet.Core         2.14.0    MyNuGet    NuGet.Core is the core framework assembly for NuGet...

Find-Package usa el parámetro Provider para especificar el proveedor NuGet.

Ejemplo 2: Buscar un paquete desde un origen de paquete

Este comando busca la versión más reciente de un paquete desde un origen de paquete especificado. Si no se proporciona un origen de paquete, Find-Package busca en cada proveedor de paquetes instalado y en sus orígenes de paquetes. Use Get-PackageSource para obtener el nombre de origen.

Find-Package -Name NuGet.Core -Source MyNuGet

Name         Version   Source    Summary
----         -------   ------    -------
NuGet.Core   2.14.0    MyNuGet   NuGet.Core is the core framework assembly for NuGet...

Find-Package usa el parámetro Name para especificar el nombre del paquete NuGet.Core. El parámetro Source especifica que se va a buscar el paquete en MyNuGet.

Ejemplo 3: Buscar todas las versiones de un paquete

Este comando busca todas las versiones de paquete disponibles de un proveedor especificado.

Find-Package -Name NuGet.Core -Source MyNuGet -AllVersions

Name          Version          Source       Summary
----          -------          ------       -------
NuGet.Core    2.14.0           MyNuGet      NuGet.Core is the core framework assembly for NuGet...
NuGet.Core    2.14.0-rtm-832   MyNuGet      NuGet.Core is the core framework assembly for NuGet...
NuGet.Core    2.13.0           MyNuGet      NuGet.Core is the core framework assembly for NuGet...
...
NuGet.Core    1.1.229.159      MyNuGet      NuGet.Core is the core framework assembly for NuGet...
Nuget.Core    1.0.1120.104     MyNuGet      NuGet.Core is the core framework assembly for NuGet...

Find-Package usa el parámetro Name para especificar el paquete NuGet.Core. El parámetro ProviderName especifica que se va a buscar el paquete en MyNuGet. AllVersions especifica que se devuelven todas las versiones disponibles.

Ejemplo 4: Buscar un paquete con un nombre y una versión específicos

Este comando busca una versión de paquete específica de un proveedor especificado.

Find-Package -Name NuGet.Core -ProviderName NuGet -RequiredVersion 2.9.0

Name          Version          Source       Summary
----          -------          ------       -------
NuGet.Core    2.9.0            MyNuGet      NuGet.Core is the core framework assembly for NuGet...

Ejemplo 5: Buscar paquetes dentro de un intervalo de versiones

Este comando busca un intervalo de versiones para un paquete especificado.

Find-Package -Name NuGet.Core -ProviderName NuGet -MinimumVersion 2.7.0 -MaximumVersion 2.9.0 -AllVersions

Name          Version          Source       Summary
----          -------          ------       -------
NuGet.Core    2.9.0            MyNuGet      NuGet.Core is the core framework assembly for NuGet...
NuGet.Core    2.8.6            MyNuGet      NuGet.Core is the core framework assembly for NuGet...
NuGet.Core    2.8.0            MyNuGet      NuGet.Core is the core framework assembly for NuGet...
NuGet.Core    2.7.0            MyNuGet      NuGet.Core is the core framework assembly for NuGet...

Find-Package usa el parámetro Name para especificar el nombre del paquete NuGet.Core. El parámetro ProviderName especifica para buscar el paquete en NuGet. MinimumVersion especifica la versión 2.7.0 más baja. MaximumVersion especifica la versión 2.9.0 más alta. AllVersions determina que el intervalo se devuelve según lo especificado por el mínimo y máximo.

Ejemplo 6: Buscar un paquete desde un sistema de archivos

Este comando busca paquetes con la extensión .nupkg de archivo que se almacenan en el equipo local. Los archivos son paquetes descargados de una galería como NuGet.

PS> Find-Package -Source C:\LocalPkg

Name                 Version    Source           Summary
----                 -------    ------           -------
Microsoft.Web.Xdt    3.0.0      C:\LocalPkg\     Microsoft Xml Document Transformation (XDT)...
NuGet.Core           2.14.0     C:\LocalPkg\     NuGet.Core is the core framework assembly...

Parámetros

-AcceptLicense

Acepta automáticamente un contrato de licencia si el paquete lo requiere.

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

-AllowPrereleaseVersions

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

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

-AllVersions

Indica que Find-Package devuelve todas las versiones disponibles del paquete. De forma predeterminada, Find-Package solo devuelve la versión más reciente disponible.

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

-Command

Especifica una matriz de comandos buscados por Find-Package.

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

-ConfigFile

Especifica un archivo de configuración.

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

-Contains

Find-Package obtiene objetos si algún elemento de los valores de propiedad del objeto es una coincidencia exacta para el valor especificado.

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

-Credential

Especifica una cuenta de usuario que tiene permiso para buscar paquetes.

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

-DscResource

Especifica una matriz de recursos de Desired State Configuration (DSC) que busca este cmdlet.

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

-Filter

Especifica los términos que se van a buscar en las propiedades Nombre y Descripción .

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

-FilterOnTag

Especifica la etiqueta que filtra los resultados. Se excluyen los resultados que no contienen la etiqueta especificada.

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

-Force

Obliga al comando a ejecutarse sin solicitar la confirmación del usuario.

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

-ForceBootstrap

Indica que Find-Package obliga a PackageManagement a instalar automáticamente el proveedor de paquetes.

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

-Headers

Especifica los encabezados del paquete.

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

-IncludeDependencies

Indica que este cmdlet incluye dependencias de paquete en los resultados.

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

-Includes

Especifica si Find-Package debe encontrar todos los paquetes dentro de una categoría.

Los valores aceptados son los siguientes:

Cmdlet
DscResource
Función
RoleCapability
Flujo de trabajo

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

-MaximumVersion

Especifica la versión máxima del paquete que desea buscar.

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

-MinimumVersion

Especifica la versión mínima del paquete que desea buscar. Si hay disponible una versión superior, se devuelve esa versión.

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

-Name

Especifica uno o varios nombres de paquete o nombres de paquete con caracteres comodín. Separe varios nombres de paquete con comas.

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

-PackageManagementProvider

Especifica el nombre de un proveedor de administración de paquetes.

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

-ProviderName

Especifica uno o varios nombres de proveedor de paquetes. Separe varios nombres de proveedor de paquetes con comas. Use Get-PackageProvider para obtener una lista de proveedores de paquetes disponibles.

Type:	String[]
Aliases:	Provider
Accepted values:	Bootstrap, NuGet, PowerShellGet
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Proxy

Especifica un servidor proxy para la solicitud, en lugar de una conexión directa al recurso de Internet.

Type:	Uri
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
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:	False
Accept wildcard characters:	False

-PublishLocation

Especifica una ubicación para publicar el paquete.

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

-RequiredVersion

Especifica una versión exacta del paquete que desea buscar.

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

-RoleCapability

Especifica una matriz de funcionalidades de rol.

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

-ScriptPublishLocation

Especifica una ubicación de publicación de script para el paquete.

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

-ScriptSourceLocation

Especifica una ubicación de origen de script.

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

-SkipValidate

Cambie que omita la validación de credenciales de paquete.

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

-Source

Especifica uno o varios orígenes de paquetes. Use Get-PackageSource para obtener una lista de los orígenes de paquetes disponibles. Un directorio del sistema de archivos se puede usar como origen para los paquetes de descarga.

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

-Tag

Especifica una o varias cadenas que se van a buscar en los metadatos del paquete.

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

-Type

Especifica si se deben buscar paquetes con un módulo, un script o cualquiera de ellos.

Type:	String
Accepted values:	Module, Script, All
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

None

No se pueden canalizar objetos a este cmdlet.

Salidas

SoftwareIdentify[]

Este cmdlet devuelve un objeto SoftwareIdentity .

Notas