Compartir a través de

Register-PSRepository

  • Referencia
Módulo:
PowerShellGet

Registra un repositorio de PowerShell.

Syntax

Register-PSRepository
        [-Name] <String>
        [-SourceLocation] <Uri>
        [-PublishLocation <Uri>]
        [-ScriptSourceLocation <Uri>]
        [-ScriptPublishLocation <Uri>]
        [-Credential <PSCredential>]
        [-InstallationPolicy <String>]
        [-Proxy <Uri>]
        [-ProxyCredential <PSCredential>]
        [-PackageManagementProvider <String>]
        [<CommonParameters>]
Register-PSRepository
        [-Default]
        [-InstallationPolicy <String>]
        [-Proxy <Uri>]
        [-ProxyCredential <PSCredential>]
        [<CommonParameters>]

Description

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

Los repositorios registrados son específicos del usuario. No se registran en el contexto del 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

$parameters = @{
  Name = "myNuGetSource"
  SourceLocation = "https://www.myget.org/F/mypsrepository/api/v2"
  PublishLocation = "https://www.myget.org/F/mypsrepository/api/v2/Packages"
  InstallationPolicy = 'Trusted'
}
Register-PSRepository @parameters
Get-PSRepository

Name                SourceLocation          OneGetProvider       InstallationPolicy
----                --------------          --------------       ------------------
PSGallery           http://go.micro...      NuGet                Untrusted
myNuGetSource       https://myget.c...      NuGet                Trusted

El primer comando se registra https://www.myget.org/F/mypsrepository/ 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 los asocia al proveedor de NuGet.

El segundo comando obtiene repositorios registrados y muestra los resultados.

Parámetros

-Credential

Especifica las credenciales de una cuenta que tiene derechos para registrar un repositorio.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Default

El parámetro se usa para registrar psGallery. Solo tiene que hacerlo si ha quitado el repositorio psgallery .

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

-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 InstallationPolicy con el Set-PSRepository cmdlet .

Type:String
Accepted values:Trusted, Untrusted
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 y Install-Module.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 con el primer proveedor de paquetes que indica que puede controlar el repositorio.

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

-Proxy

Especifica un servidor proxy para la solicitud, en lugar de conectarse directamente al recurso de Internet.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ProxyCredential

Especifica una cuenta de usuario que tiene permiso para usar el servidor proxy especificado por el parámetro Proxy.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PublishLocation

Especifica el URI de la ubicación de publicación para los módulos. Por ejemplo, para repositorios basados en NuGet, la ubicación de publicación es similar a https://someNuGetUrl.com/api/v2/package.

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

-ScriptPublishLocation

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

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

-ScriptSourceLocation

Especifica el URI para detectar e instalar scripts 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 https://someNuGetUrl.com/api/v2/items/psscript.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 https://someNuGetUrl.com/api/v2.

Type:Uri
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Entradas

PSCredential

Uri

Salidas

Object

Notas

Importante

A partir de abril de 2020, Galería de PowerShell ya no es compatible con las versiones 1.0 y 1.1 de Seguridad de la capa de transporte (TLS). Si no usa TLS 1.2 o una versión posterior, recibirá un error al intentar obtener acceso a Galería de PowerShell. Use el siguiente comando para asegurarse de que usa TLS 1.2:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Para más información, consulte el anuncio en el blog de PowerShell.