Install-PSResource
Instala recursos desde un repositorio registrado.
Syntax
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 acceso de instalación en un equipo. 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.
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 dentro de 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 los PSResources especificados en el archivo psd1.
Install-PSResource -RequiredResourceFile myRequiredModules.psd1
Ejemplo 5
Instala los PSResources especificados 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AuthenticodeCheck
Valida las firmas Authenticode y los archivos de catálogo en Windows.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Credenciales opcionales usadas al acceder a un repositorio.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Se usa para la entrada de canalización.
Type: | Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[] |
Aliases: | ParentResource |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Nombre de uno o varios recursos que se van a instalar.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoClobber
Impide la instalación de un paquete que contiene cmdlets que ya existen en el equipo.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Cuando se especifica, genera un objeto PSResourceInfo para el recurso guardado.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Prerelease
Cuando se especifica, incluye versiones preliminares en los resultados de búsqueda devueltos.
Type: | SwitchParameter |
Aliases: | IsPrerelease |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Quiet
Suprime la barra de progreso de la instalación.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 con 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | Object |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequiredResourceFile
Ruta de acceso a un .psd1
objeto 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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
Type: | Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType |
Accepted values: | CurrentUser, AllUsers |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipDependencyCheck
Omite la comprobación de las dependencias de recursos. Solo se instalan los recursos encontrados. No se instala ningún recurso del recurso encontrado.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TrustRepository
Suprima los avisos para confiar en el repositorio. La solicitud para confiar en el repositorio solo se produce si el repositorio no está configurado como de confianza.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 que aparecen en la documentación del intervalo de versiones de NuGet. El uso 1.0.0.0
de como versión no produce las versiones 1.0.0.0 y 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
String[]
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 un 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.
Vínculos relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de