Register-PSResourceRepository

Sintaxis

NameParameterSet (valor predeterminado)

Register-PSResourceRepository
    [-Name] <string>
    [-Uri] <string>
    [-Trusted]
    [-Priority <int>]
    [-ApiVersion <PSRepositoryInfo+APIVersion>]
    [-CredentialInfo <PSCredentialInfo>]
    [-CredentialProvider <CredentialProvider>]
    [-PassThru]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

PSGalleryParameterSet

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

MARParameterSet

Register-PSResourceRepository
    -MicrosoftArtifactRegistry
    [-Trusted]
    [-Priority <int>]
    [-PassThru]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RepositoriesParameterSet

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

Description

Ejemplos

Ejemplo 1

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

Register-PSResourceRepository -PSGallery
Get-PSResourceRepository -Name 'PSGallery'

Name             Uri                                          Trusted   Priority
----             ---                                          -------   --------
PSGallery        https://www.powershellgallery.com/api/v2       False         50

Ejemplo 3

$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

$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
• ContainerRegistry: se usa para Azure Container Registry
• Local: úselo para repositorios basados en el sistema de archivos
• NugetServer: úselo para repositorios basados en NuGet.Server

El cmdlet Register-PSResourceRepository 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.

Propiedades de parámetro

Conjuntos de parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Conjuntos de parámetros

-CredentialInfo

Objeto PSCredentialInfo que incluye el nombre de un almacén y un secreto almacenado en un almacén de Microsoft.PowerShell.SecretManagement.

Propiedades de parámetro

Conjuntos de parámetros

-CredentialProvider

Este es un parámetro dinámico que especifica el proveedor de credenciales a utilizar para el repositorio. Este parámetro solo está disponible cuando el repositorio que se está registrando es una fuente Azure Artifacts. Los valores válidos son:

• None - No se define ningún proveedor de credenciales
• AzArtifacts - Utilizar el proveedor de credenciales de artefactos de Azure

Si no usas este parámetro, el valor por defecto es None. Si la URL del repositorio contiene pkgs.dev.azure.com o pkgs.visualstudio.com, el comando registra automáticamente el repositorio con la propiedad CredentialProvider establecida en AzArtifacts.

Propiedades de parámetro

Conjuntos de parámetros

-Force

Sobrescribe un repositorio si ya existe.

Propiedades de parámetro

Conjuntos de parámetros

-MicrosoftArtifactRegistry

Cuando se especifica, registra el repositorio predeterminado MicrosoftArtifactRegistry con las siguientes configuraciones:

• Name - MicrosoftArtifactRegistry
• Uri - https://mcr.microsoft.com/
• Trusted - Cierto
• Priority - 40
• ApiVersion - ContainerRegistry

Por defecto, el MicrosoftArtifactRegistry repositorio se registra como un repositorio de confianza con una prioridad superior a la del PSGallery repositorio.

No puedes usar este parámetro para restablecer el repositorio existente. Úsalo Set-PSResourceRepository para cambiar la configuración del repositorio existente.

Este parámetro se añadió en Microsoft. PowerShell.PSResourceGet v1.3.0-preview1.

Propiedades de parámetro

Conjuntos de parámetros

-Name

Nombre del repositorio que se va a registrar. No puede ser PSGallery ni MicrosoftArtifactRegistry.

Propiedades de parámetro

Conjuntos de parámetros

-PassThru

Cuando se especifica, muestra el repositorio registrado correctamente y su información.

Propiedades de parámetro

Conjuntos de parámetros

-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 de PSResourceGet buscan en los repositorios con este criterio de ordenación y devuelven la primera coincidencia encontrada.

Propiedades de parámetro

Conjuntos de parámetros

-PSGallery

Cuando se especifica, registra el repositorio predeterminado PSGallery con las siguientes configuraciones:

• Name - PSGallery
• Uri - https://www.powershellgallery.com/api/v2
• Trusted - Falso
• Priority - 50
• ApiVersion - V2

Por defecto, el PSGallery repositorio se registra como un repositorio No Confiable con una prioridad inferior a la del MicrosoftArtifactRegistry repositorio.

Puedes usar esto para restaurar el registro por defecto del PSGallery repositorio si ha sido eliminado. No puedes usar este parámetro para restablecer el repositorio existente. Úsalo Set-PSResourceRepository para cambiar la configuración del repositorio existente.

Propiedades de parámetro

Conjuntos de parámetros

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

Propiedades de parámetro

Conjuntos de parámetros

-Trusted

Especifica si el repositorio debe ser de confianza.

Propiedades de parámetro

Conjuntos de parámetros

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

Propiedades de parámetro

Conjuntos de parámetros

-WhatIf

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

Propiedades de parámetro

Conjuntos de parámetros

CommonParameters

Entradas

None

Salidas

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo

Notas

Vínculos relacionados

• Microsoft.PowerShell.SecretManagement
• Get-PSResourceRepository
• Set-PSResourceRepository
• Reset-PSResourceRepository
• Unregister-PSResourceRepository