Compartir a través de

Get-Package

  • Referencia
Módulo:
PackageManagement

Devuelve una lista de todos los paquetes de software que se instalaron con PackageManagement.

Syntax

Get-Package
   [[-Name] <String[]>]
   [-RequiredVersion <String>]
   [-MinimumVersion <String>]
   [-MaximumVersion <String>]
   [-AllVersions]
   [-Force]
   [-ForceBootstrap]
   [-ProviderName <String[]>]
   [-Destination <String>]
   [-ExcludeVersion]
   [-Scope <String>]
   [-SkipDependencies]
   [<CommonParameters>]
Get-Package
   [[-Name] <String[]>]
   [-RequiredVersion <String>]
   [-MinimumVersion <String>]
   [-MaximumVersion <String>]
   [-AllVersions]
   [-Force]
   [-ForceBootstrap]
   [-ProviderName <String[]>]
   [-Scope <String>]
   [-PackageManagementProvider <String>]
   [-Type <String>]
   [-AllowClobber]
   [-SkipPublisherCheck]
   [-InstallUpdate]
   [-NoPathUpdate]
   [-AllowPrereleaseVersions]
   [<CommonParameters>]

Description

El Get-Package cmdlet devuelve una lista de todos los paquetes de software del equipo local que se instalaron con PackageManagement. Puede ejecutarse Get-Package en equipos remotos ejecutándolo como parte de un Invoke-Command comando o Enter-PSSession o script.

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: Obtener todos los paquetes instalados

El Get-Package cmdlet obtiene todos los paquetes instalados en el equipo local.

Get-Package

Name           Version      Source                                     ProviderName
----           -------      ------                                     ------------
posh-git       0.7.3        https://www.powershellgallery.com/api/v2   PowerShellGet

Ejemplo 2: Obtener paquetes instalados en un equipo remoto

Este comando obtiene una lista de paquetes instalados por PackageManagement en un equipo remoto. Este comando le pide que proporcione la contraseña del usuario especificado.

PS> Invoke-Command -ComputerName Server01 -Credential CONTOSO\TestUser -ScriptBlock {Get-Package}

Invoke-Command usa el parámetro ComputerName para especificar un equipo remoto, Server01. El parámetro Credential especifica un dominio y un nombre de usuario con permisos para ejecutar comandos en el equipo. El parámetro ScriptBlock ejecuta el Get-Package cmdlet en el equipo remoto.

Ejemplo 3: Obtener paquetes para un proveedor especificado

Este comando obtiene paquetes de software instalados en el equipo local desde un proveedor específico.

Get-Package -ProviderName PowerShellGet -AllVersions

Name                  Version      Source                                     ProviderName
----                  -------      ------                                     ------------
PackageManagement     1.2.2        https://www.powershellgallery.com/api/v2   PowerShellGet
PackageManagement     1.3.1        https://www.powershellgallery.com/api/v2   PowerShellGet
posh-git              0.7.3        https://www.powershellgallery.com/api/v2   PowerShellGet
PowerShellGet         2.0.1        https://www.powershellgallery.com/api/v2   PowerShellGet

Get-Package usa el parámetro ProviderName para especificar un proveedor específico, PowerShellGet. El parámetro AllVersions muestra cada versión instalada.

Ejemplo 4: Obtener una versión exacta de un paquete específico

Este comando obtiene una versión específica de un paquete instalado. Se puede instalar más de una versión de un paquete.

Get-Package -Name PackageManagement -ProviderName PowerShellGet -RequiredVersion 1.3.1

Name                  Version      Source                                     ProviderName
----                  -------      ------                                     ------------
PackageManagement     1.3.1        https://www.powershellgallery.com/api/v2   PowerShellGet

Get-Package usa el parámetro Name para especificar el nombre del paquete, PackageManagement. El parámetro ProviderName especifica el proveedor, PowerShellGet. El parámetro RequiredVersion especifica una versión instalada.

Ejemplo 5: Desinstalar un paquete

En este ejemplo se obtiene información del paquete y, a continuación, se desinstala el paquete.

Get-Package -Name posh-git -RequiredVersion 0.7.3 | Uninstall-Package

Get-Package usa el parámetro Name para especificar el nombre del paquete, posh-git. El parámetro RequiredVersion es una versión específica del paquete. El objeto se envía por la canalización al Uninstall-Package cmdlet . Uninstall-Package quita el paquete.

Parámetros

-AllowClobber

Invalida mensajes de advertencia sobre conflictos con comandos existentes. Sobrescribe los comandos existentes que tienen el mismo nombre que los comandos que instala un módulo.

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 Get-Package devuelve todas las versiones disponibles del paquete. De forma predeterminada, Get-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

-Destination

Especifica la ruta de acceso a un directorio que contiene archivos de paquete extraídos.

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

-ExcludeVersion

Cambie para excluir el número de versión en la ruta de acceso de la carpeta.

Type:SwitchParameter
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 Get-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

-InstallUpdate

Indica que este cmdlet instala actualizaciones.

Type:SwitchParameter
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

-NoPathUpdate

NoPathUpdate solo se aplica al Install-Script cmdlet . NoPathUpdate es un parámetro dinámico agregado por el proveedor y no es compatible con Get-Package.

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

-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

-RequiredVersion

Especifica la versión exacta del paquete que se va a buscar.

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

-Scope

Especifica el ámbito de búsqueda del paquete.

Type:String
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipDependencies

Modificador que especifica omitir la búsqueda de las dependencias del paquete.

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

-SkipPublisherCheck

Permite obtener una versión de paquete más reciente que la versión instalada. Por ejemplo, un paquete instalado firmado digitalmente por un editor de confianza, pero una nueva versión no está firmada digitalmente.

Type:SwitchParameter
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

Salidas

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Este cmdlet devuelve un objeto SoftwareIdentity para cada paquete instalado que coincida con los parámetros. De forma predeterminada, devuelve todos los paquetes instalados.

Notas

Incluir un proveedor de paquetes en un comando puede hacer que los parámetros dinámicos estén disponibles para un cmdlet. Los parámetros dinámicos son específicos de un proveedor de paquetes. El Get-Help cmdlet enumera los conjuntos de parámetros de un cmdlet e incluye el conjunto de parámetros del proveedor. Por ejemplo, Get-Package tiene establecido el parámetro PowerShellGet que incluye -NoPathUpdate, AllowClobbery SkipPublisherCheck.

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.