Register-PSResourceRepository

Register-PSResourceRepository
    [-Name] <String>
    [-Uri] <String>
    [-Trusted]
    [-Priority <Int32>]
    [-ApiVersion <APIVersion>]
    [-CredentialInfo <PSCredentialInfo>]
    [-PassThru]
    [-Force]
    [-CredentialProvider <CredentialProvider>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Register-PSResourceRepository
    [-PSGallery]
    [-Trusted]
    [-Priority <Int32>]
    [-PassThru]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Register-PSResourceRepository
    -Repository <Hashtable[]>
    [-PassThru]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

El cmdlet registra un repositorio NuGet que contiene recursos de PowerShell.

En este ejemplo se registra el repositorio con el Nombre de de .

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

En este ejemplo se registra el repositorio de PSGallery predeterminado. A diferencia del ejemplo anterior, no se pueden usar los parámetros de Name y URI para registrar el repositorio de PSGallery. El repositorio de PSGallery 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

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 el NameParameterSet o la 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

En este ejemplo se registra un repositorio con información de credenciales que se va a recuperar de un almacén de SecretManagement registrado, donde SecretStore es el nombre del almacén y TestSecret es el nombre del secreto almacenado.

Debe tener instalado el módulo Microsoft.PowerShell.SecretManagement , tener un almacén registrado y almacenar un secreto en él. Si se configura correctamente, el comando Get-SecretInfo -Name 'TestSecret' devolverá el secreto.

El formato del secreto debe coincidir con los requisitos del repositorio. En algunos casos, TestSecret es posible que sea necesario almacenarlo como un objeto PSCredential con un nombre de usuario y una contraseña o token. En otros, es posible que sea necesario almacenarlo como un SecureString que representa solo el token.

$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     :

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.

De forma predeterminada, el cmdlet no genera ninguna salida. Cuando se usa el parámetro PassThru, el cmdlet devuelve un objeto PSRepositoryInfo.

Los repositorios son únicos por Nombre. Si se intenta registrar un repositorio con el mismo nombre, se produce un error.