Register-PSResourceRepository
Registra un repositorio para los recursos de PowerShell.
Sintaxis
Register-PSResourceRepository
[-Name] <String>
[-Uri] <String>
[-Trusted]
[-Priority <Int32>]
[-ApiVersion <APIVersion>]
[-CredentialInfo <PSCredentialInfo>]
[-PassThru]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Register-PSResourceRepository
[-PSGallery]
[-Trusted]
[-Priority <Int32>]
[-PassThru]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Register-PSResourceRepository
-Repository <Hashtable[]>
[-PassThru]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
El cmdlet registra un repositorio NuGet que contiene recursos de PowerShell.
Ejemplos
Ejemplo 1
En este ejemplo se registra el repositorio con el nombre de PoshTestGallery
.
Register-PSResourceRepository -Name PoshTestGallery -Uri 'https://www.poshtestgallery.com/api/v2'
Get-PSResourceRepository -Name PoshTestGallery
Name Uri Trusted Priority
---- --- ------- --------
PoshTestGallery https://www.poshtestgallery.com/api/v2 False 50
Ejemplo 2
En este ejemplo se registra el repositorio predeterminado PSGallery
. A diferencia del ejemplo anterior, no se pueden usar los parámetros Name y URI para registrar el PSGallery
repositorio. El PSGallery
repositorio se registra de forma predeterminada, pero se puede quitar. Use este comando para restaurar el registro predeterminado.
Register-PSResourceRepository -PSGallery
Get-PSResourceRepository -Name 'PSGallery'
Name Uri Trusted Priority
---- --- ------- --------
PSGallery https://www.powershellgallery.com/api/v2 False 50
Ejemplo 3
En este ejemplo se registran varios repositorios a la vez. Para ello, usamos el parámetro Repository y proporcionamos una matriz de tablas hash. Cada tabla hash solo puede tener claves asociadas a parámetros para NameParameterSet o PSGalleryParameterSet.
$arrayOfHashtables = @{
Name = 'Local'
Uri = 'D:/PSRepoLocal/'
Trusted = $true
Priority = 20
},
@{
Name = 'PSGv3'
Uri = 'https://www.powershellgallery.com/api/v3'
Trusted = $true
Priority = 50
},
@{
PSGallery = $true
Trusted = $true
Priority = 10
}
Register-PSResourceRepository -Repository $arrayOfHashtables
Get-PSResourceRepository
Name Uri Trusted Priority
---- --- ------- --------
PSGallery https://www.powershellgallery.com/api/v2 True 10
Local file:///D:/PSRepoLocal/ True 20
PSGv3 https://www.powershellgallery.com/api/v3 True 50
Ejemplo 4
En este ejemplo se registra un repositorio con información de credenciales que se va a recuperar de un almacén de SecretManagement registrado. Debe tener instalado el módulo Microsoft.PowerShell.SecretManagement y tener un almacén registrado que contenga el secreto almacenado. El formato del secreto debe coincidir con los requisitos del repositorio.
$parameters = @{
Name = 'PSGv3'
Uri = 'https://www.powershellgallery.com/api/v3'
Trusted = $true
Priority = 50
CredentialInfo = [Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCredentialInfo]::new(
'SecretStore', 'TestSecret')
}
Register-PSResourceRepository @parameters
Get-PSResourceRepository | Select-Object * -ExpandProperty CredentialInfo
Name : PSGv3
Uri : https://www.powershellgallery.com/api/v3
Trusted : True
Priority : 50
CredentialInfo : Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCredentialInfo
VaultName : SecretStore
SecretName : TestSecret
Credential :
Parámetros
-ApiVersion
Especifica la versión de la API que usa el repositorio. Los valores válidos son:
v2
: usa la API de NuGet V2.v3
: usa la API de NuGet V3.local
: se usa para repositorios basados en el sistema de archivos.nugetServer
: se usa para repositorios basados en NuGet.Server.
El Register-PSResourceRepository
cmdlet debe detectar automáticamente la versión de la API. Este parámetro permite cambiar la versión de la API después de haber registrado un repositorio.
Tipo: | Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo+APIVersion |
Valores aceptados: | unknown, v2, v3, local, nugetServer |
Posición: | Named |
Valor predeterminado: | None |
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 |
-CredentialInfo
Objeto PSCredentialInfo que incluye el nombre de un almacén y un secreto almacenado en un almacén Microsoft.PowerShell.SecretManagement .
Tipo: | Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCredentialInfo |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Force
Sobrescribe un repositorio si ya existe.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | False |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Name
Nombre del repositorio que se va a registrar. No puede ser PSGallery
.
Tipo: | String |
Posición: | 0 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-PassThru
Cuando se especifica, muestra el repositorio registrado correctamente y su información.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | False |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Priority
Especifica la clasificación de prioridad del repositorio. Los valores de prioridad válidos oscilan entre 0 y 100. Los valores más bajos tienen una clasificación de prioridad más alta. El valor predeterminado es 50
.
Los repositorios se ordenan por prioridad y, a continuación, por nombre. Al buscar recursos en varios repositorios, los cmdlets PSResourceGet buscan en los repositorios con este criterio de ordenación y devuelven la primera coincidencia encontrada.
Tipo: | Int32 |
Posición: | Named |
Valor predeterminado: | 50 |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-PSGallery
Cuando se especifica, registra el repositorio PSGallery .
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | False |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Repository
Especifica una matriz de tablas hash que contienen información del repositorio. Use este parámetro para registrar varios repositorios a la vez. Cada tabla hash solo puede tener claves asociadas a parámetros para NameParameterSet o PSGalleryParameterSet.
Tipo: | Hashtable[] |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Trusted
Especifica si el repositorio debe ser de confianza.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | False |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Uri
Especifica la ubicación del repositorio que se va a registrar. El valor debe usar uno de los siguientes esquemas de URI:
https://
http://
ftp://
file://
Tipo: | String |
Posición: | 1 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-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
None
Salidas
Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo
De forma predeterminada, el cmdlet no genera ninguna salida. Cuando se usa el parámetro PassThru , el cmdlet devuelve un objeto PSRepositoryInfo .
Notas
Los repositorios son únicos por Nombre. Si se intenta registrar un repositorio con el mismo nombre, se produce un error.