Compartir por

Update-PSResource

  • Referencia
Módulo:
Microsoft.PowerShell.PSResourceGet

Descarga e instala la versión más reciente de un paquete ya instalado en el equipo local.

Sintaxis

Update-PSResource
      [[-Name] <String[]>]
      [-Version <String>]
      [-Prerelease]
      [-Repository <String[]>]
      [-Scope <ScopeType>]
      [-TemporaryPath <String>]
      [-TrustRepository]
      [-Credential <PSCredential>]
      [-Quiet]
      [-AcceptLicense]
      [-Force]
      [-PassThru]
      [-SkipDependencyCheck]
      [-AuthenticodeCheck]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Update-PSResource descarga e instala la versión más reciente de un paquete ya instalado en el equipo local. Este cmdlet reemplaza los Update-Module cmdlets y Update-Script de PowerShellGet v2. La nueva versión del recurso se instala en paralelo con las versiones anteriores en una nueva carpeta con versiones nuevas.

De forma predeterminada, Update-PSResource instala la versión más reciente del paquete y cualquiera de sus dependencias sin eliminar las versiones anteriores instaladas. No hay ningún comando para desinstalar versiones anteriores de un paquete. Debe eliminar manualmente los archivos y carpetas de las versiones anteriores.

Update-PSResource no carga el módulo actualizado en la sesión actual. Debe importar la nueva versión o iniciar una nueva sesión para usar el módulo actualizado. Para obtener más información, consulte Import-Module.

Ejemplos

Ejemplo 1

En este ejemplo, el usuario ya tiene instalado el paquete TestModule y actualiza el paquete.

Get-PSResource -Name "TestModule"

Name                                    Version                         Prerelease   Description
----                                    -------                         ----------   -----------
TestModule                              1.2.0                                        test

Update-PSResource -Name "TestModule"

Name                                    Version                         Prerelease   Description
----                                    -------                         ----------   -----------
TestModule                              1.3.0                                        test
TestModule                              1.2.0                                        test

Parámetros

-AcceptLicense

Para los recursos que requieren una licencia, AcceptLicense acepta automáticamente el contrato de licencia durante la actualización.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AuthenticodeCheck

Valida los archivos firmados y los archivos de catálogo en Windows.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Credential

Especifica las credenciales opcionales que se usan al acceder a un repositorio privado.

Tipo:PSCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

Cuando se especifica, omite las comprobaciones de TrustRepository y AcceptLicense y actualiza el paquete.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifica el nombre de uno o varios recursos que se van a actualizar. Se admiten caracteres comodín, pero NuGet solo acepta el * carácter. NuGet no admite búsquedas comodín de repositorios locales (basados en archivos).

Tipo:String[]
Posición:0
Valor predeterminado:"*"
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:True

-PassThru

Cuando se especifica, genera un objeto PSResourceInfo para el recurso guardado.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Prerelease

Cuando se especifica, permite actualizar a una versión preliminar.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Quiet

Suprime la información de progreso.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Repository

Especifica uno o varios nombres de repositorio que se van a buscar. Si no se especifica, la búsqueda incluye todos los repositorios registrados, en orden de prioridad (más alto primero), hasta que se encuentre un repositorio que contenga el paquete. Los repositorios se ordenan por prioridad y, a continuación, por nombre. Los valores de prioridad inferior tienen una prioridad mayor.

Al buscar recursos en varios repositorios, los cmdlets PSResourceGet buscan en los repositorios mediante este criterio de ordenación. Update-PSResource actualiza el primer paquete coincidente de la lista ordenada de repositorios.

El parámetro admite el * carácter comodín. Si especifica varios repositorios, todos los nombres deben incluir o omitir el carácter comodín. No se puede especificar una combinación de nombres con y sin caracteres comodín.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

-Scope

Especifica el ámbito de instalación. Los valores aceptados son:

  • CurrentUser
  • AllUsers

El ámbito predeterminado es CurrentUser, que no requiere elevación.

Tipo:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Valores aceptados:CurrentUser, AllUsers
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SkipDependencyCheck

Omite la comprobación de las dependencias de recursos. Esto significa que solo se actualizan los recursos con nombre.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-TemporaryPath

Especifica la ruta de acceso para instalar temporalmente el recurso antes de la instalación real. Si no se proporciona ninguna ruta de acceso temporal, el recurso se instala temporalmente en la carpeta temporal del usuario actual.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-TrustRepository

Suprima las indicaciones para confiar en el repositorio. La solicitud para confiar en el repositorio solo se produce si el repositorio no está configurado como de confianza.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Version

Especifica la versión del recurso que se va a devolver. El valor puede ser una versión exacta o un intervalo de versiones mediante la sintaxis de control de versiones de NuGet.

Para obtener más información sobre los intervalos de versiones de NuGet, consulte Control de versiones de paquetes.

PowerShellGet admite todas las versiones inclusivas mínimas enumeradas en la documentación del intervalo de versiones de NuGet. El uso 1.0.0.0 de como versión no produce versiones 1.0.0.0 ni posteriores (intervalo inclusivo mínimo). En su lugar, el valor se considera la versión necesaria. Para buscar un intervalo inclusivo mínimo, use [1.0.0.0, ] como intervalo de versiones.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String[]

Salidas

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

De forma predeterminada, el cmdlet no devuelve ningún objeto. Cuando se usa el parámetro PassThru , el cmdlet genera un objeto PSResourceInfo para el recurso guardado.

Notas

El módulo define udres como alias para Update-PSResource.