Compartir a través de

Update-PSResource

Módulo:
Microsoft.PowerShell.PSResourceGet Module

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

Sintaxis

Default (valor predeterminado) 

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 cmdlets Update-Module 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, vea 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

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AuthenticodeCheck

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Credential

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

Propiedades de parámetro

Tipo:PSCredential
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Force

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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).

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:*
Admite caracteres comodín:True
DontShow:False

Conjuntos de parámetros

(All)
Posición:0
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-PassThru

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Prerelease

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Quiet

Suprime la información de progreso.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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 menor tienen una prioridad más alta.

Al buscar recursos en varios repositorios, los cmdlets de PSResourceGet buscan en los repositorios con 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.

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:True
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Scope

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

  • CurrentUser
  • AllUsers

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

Propiedades de parámetro

Tipo:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Valor predeterminado:None
Valores aceptados:CurrentUser, AllUsers
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SkipDependencyCheck

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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 todos los versión inclusiva mínima que se enumeran en la documentación del intervalo de versiones de NuGet. El uso de 1.0.0.0, ya que la 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.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:True
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

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.