Install-PSResource

  • Referencia
Módulo:
Microsoft.PowerShell.PSResourceGet

Instala recursos desde un repositorio registrado.

Sintaxis

Install-PSResource
       [-Name] <String[]>
       [-Version <String>]
       [-Prerelease]
       [-Repository <String[]>]
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Install-PSResource
       [-Repository <String[]>]
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       [-InputObject] <PSResourceInfo[]>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Install-PSResource
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       -RequiredResourceFile <String>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Install-PSResource
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       -RequiredResource <Object>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

Este cmdlet instala los recursos de un repositorio registrado en una ruta de instalación en una máquina. De forma predeterminada, el cmdlet no devuelve ningún objeto. Otros parámetros permiten especificar el repositorio, el ámbito y la versión de un recurso y suprimir las solicitudes de licencia.

Este cmdlet combina las funciones de los Install-Module cmdlets y Install-Script de PowerShellGet v2.

Install-PSResource no carga el módulo recién instalado 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

Instala la versión estable (no preliminar) más reciente del módulo Az .

Install-PSResource Az

Ejemplo 2

Instala el módulo Az estable más reciente entre las versiones 7.3.0 y 8.3.0.

Install-PSResource Az -Version '[7.3.0, 8.3.0]'

Ejemplo 3

Instala la versión estable más reciente del módulo Az . Cuando se usa el parámetro Reinstall , el cmdlet escribe en cualquier versión instalada anteriormente.

Install-PSResource Az -Reinstall

Ejemplo 4

Instala psResources especificado en el archivo psd1.

Install-PSResource -RequiredResourceFile myRequiredModules.psd1

Ejemplo 5

Instala psResources especificado en la tabla hash.

Install-PSResource -RequiredResource  @{
    TestModule = @{
        version = '[0.0.1,1.3.0]'
        repository = 'PSGallery'
      }
    TestModulePrerelease = @{
        version = '[0.0.0,0.0.5]'
        repository = 'PSGallery'
        prerelease = 'true'
    }
    TestModule99 = @{}
}

Parámetros

-AcceptLicense

Especifica que el recurso debe aceptar cualquier solicitud para aceptar el contrato de licencia. Esto suprime la solicitud si el módulo exige que un usuario acepte el contrato de licencia.

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

-AuthenticodeCheck

Valida las firmas Authenticode 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

Credenciales opcionales que se usan al acceder a un repositorio.

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

-InputObject

Se usa para la entrada de canalización.

Tipo:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Alias:ParentResource
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

Nombre de uno o varios recursos que se van a instalar.

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

-NoClobber

Impide la instalación de un paquete que contiene cmdlets que ya existen en el equipo.

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

-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, incluye versiones preliminares en los resultados de búsqueda devueltos.

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

-Quiet

Suprime la barra de progreso de la instalación.

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

-Reinstall

Instala la versión más reciente de un módulo incluso si la versión más reciente ya está instalada. La versión instalada se sobrescribe. Esto le permite reparar una instalación dañada del módulo.

Si se instala una versión anterior del módulo, la nueva versión se instala en paralelo en una nueva carpeta específica de la versión.

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. Install-PSResource instala 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:True
Aceptar caracteres comodín:True

-RequiredResource

Cadena hashtable o JSON que especifica los recursos que se van a instalar. No se permiten caracteres comodín. Consulte la sección NOTES para obtener una descripción de los formatos de archivo.

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

-RequiredResourceFile

Ruta de acceso a o .psd1 .json que especifica los recursos que se van a instalar. No se permiten caracteres comodín. Consulte la sección NOTES para obtener una descripción de los formatos de archivo.

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

-Scope

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

  • CurrentUser
  • AllUsers

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

El AllUsers ámbito instala módulos en una ubicación accesible para todos los usuarios del equipo. Por ejemplo:

  • $env:ProgramFiles\PowerShell\Modules

Instala CurrentUser módulos en una ubicación accesible solo para el usuario actual del equipo. Por ejemplo:

  • $home\Documents\PowerShell\Modules
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. Solo se han instalado los recursos encontrados. No se instala ningún recurso del recurso encontrado.

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:True
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[]

String

SwitchParameter

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

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 isres como alias para Install-PSResource.

Los parámetros RequiredResource y RequiredResourceFile se usan para buscar objetos PSResource que coincidan con criterios específicos. Puede especificar los criterios de búsqueda mediante una tabla hash o un objeto JSON. Para el parámetro RequiredResourceFile , la tabla hash se almacena en un .psd1 archivo y el objeto JSON se almacena en un .json archivo. Para obtener más información, consulte about_PSResourceGet.