Compartir a través de

Register-PSResourceRepository

  • Referencia
Módulo:
Microsoft.PowerShell.PSResourceGet

Registra un repositorio para los recursos de PowerShell.

Syntax

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.

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo+APIVersion
Accepted values:unknown, v2, v3, local, nugetServer
Position:Named
Default value:None
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

-CredentialInfo

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

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCredentialInfo
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Sobrescribe un repositorio si ya existe.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32
Position:Named
Default value:50
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PSGallery

Cuando se especifica, registra el repositorio PSGallery .

Type:SwitchParameter
Position:Named
Default value:False
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:Hashtable[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Trusted

Especifica si el repositorio debe ser de confianza.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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://
Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-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

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.