Compartir a través de

Register-PSRepository

Módulo:
PowerShellGet Module

Registra un repositorio de PowerShell.

Sintaxis

Default (valor predeterminado) 

Register-PSRepository
    -Name <String>
    -SourceLocation <Uri>
    [-PublishLocation <Uri>]
    [-InstallationPolicy <String>]
    [-PackageManagementProvider <String>]
    [<CommonParameters>]

Description

El cmdlet Register-PSRepository registra el repositorio predeterminado para los módulos de PowerShell. Una vez registrado un repositorio, puede hacer referencia a él desde los cmdlets Find-Module, Install-Module y Publish-Module. El repositorio registrado se convierte en el repositorio predeterminado de Find-Module y Install-Module.

Los repositorios registrados son específicos del usuario. No están registrados en un contexto de todo el sistema.

Cada repositorio registrado está asociado a un proveedor de paquetes OneGet, que se especifica con el parámetro PackageManagementProvider. Cada proveedor de OneGet está diseñado para interactuar con un tipo específico de repositorio. Por ejemplo, el proveedor de NuGet está diseñado para interactuar con repositorios basados en NuGet. Si no se especifica un proveedor de OneGet durante el registro, PowerShellGet intenta buscar un proveedor de OneGet que pueda controlar la ubicación de origen especificada.

Ejemplos

Ejemplo 1: Registro de un repositorio

PS C:\> Register-PSRepository -Name "myNuGetSource" -SourceLocation "https://www.myget.org/F/powershellgetdemo/api/v2" -PublishLocation "https://www.myget.org/F/powershellgetdemo/api/v2/Packages" -InstallationPolicy Trusted
PS C:\> Get-PSRepository
Name                                     SourceLocation                                     OneGetProvider       InstallationPolicy
----                                     --------------                                     --------------       ------------------
PSGallery                                http://go.micro...                                 NuGet                Untrusted
myNuGetSource                            https://myget.c...                                 NuGet                Trusted

El primer comando registra https://www.myget.org/F/powershellgetdemo/ como repositorio para el usuario actual. Una vez registrado myNuGetSource, puede hacer referencia explícitamente a él al buscar, instalar y publicar módulos. Dado que no se especifica el parámetro PackageManagementProvider, el repositorio no está asociado explícitamente a un proveedor de paquetes OneGet, por lo que PowerShellGet sondea los proveedores de paquetes disponibles y lo asocia al proveedor de NuGet.

El segundo comando obtiene repositorios registrados y muestra los resultados.

Parámetros

-InstallationPolicy

Especifica la directiva de instalación. Los valores válidos son: Trusted, UnTrusted. El valor predeterminado es UnTrusted.

La directiva de instalación de un repositorio especifica el comportamiento de PowerShell al instalar desde ese repositorio. Al instalar módulos desde un repositorio que no es de confianza, se solicita confirmación al usuario.

Puede establecer el InstallationPolicy de con el cmdlet Set-PSRepository.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Valores aceptados:Trusted, Untrusted
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

Especifica el nombre del repositorio que se va a registrar. Puede usar este nombre para especificar el repositorio en cmdlets como Find-Module e Install-Module.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PackageManagementProvider

Especifica un proveedor de paquetes OneGet. Si no especifica un valor para este parámetro, PowerShellGet sondea los proveedores de paquetes disponibles y asocia este repositorio al primer proveedor de paquetes que indica que puede controlar el repositorio.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PublishLocation

Especifica el URI de la ubicación de publicación. Por ejemplo, para repositorios basados en NuGet, la ubicación de publicación es similar a http://someNuGetUrl.com/api/v2/Packages.

Propiedades de parámetro

Tipo:Uri
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SourceLocation

Especifica el URI para detectar e instalar módulos desde este repositorio. Un URI puede ser una fuente de servidor NuGet (situación más común), HTTP, HTTPS, FTP o ubicación de archivo.

Por ejemplo, para repositorios basados en NuGet, la ubicación de origen es similar a http://someNuGetUrl.com/api/v2.

Propiedades de parámetro

Tipo:Uri
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

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.