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.

Se trata de un cmdlet de proxy para el Register-PSResourceRepository cmdlet en Microsoft.PowerShell.PSResourceGet. Para obtener más información, vea Register-PSResourceRepository.

Ejemplos

Ejemplo 1: Registro de un repositorio

$parameters = @{
  Name = "myNuGetSource"
  SourceLocation = "https://www.myget.org/F/powershellgetdemo/api/v2"
  PublishLocation = "https://www.myget.org/F/powershellgetdemo/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/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 los asocia al proveedor de NuGet.

El segundo comando obtiene repositorios registrados y muestra los resultados.

Parámetros

-Credential

El cmdlet de proxy omite este parámetro, ya que no es compatible con Register-PSResourceRepository.

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

-Default

Registra Galería de PowerShell como repositorio predeterminado.

El cmdlet de proxy transforma el valor de este parámetro en el parámetro PSGallery de Register-PSResourceRepository.

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.

El cmdlet de proxy transforma el valor de este parámetro en el parámetro Trusted de Register-PSResourceRepository.

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

El cmdlet de proxy omite este parámetro, ya que no es compatible con Register-PSResourceRepository.

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

-Proxy

El cmdlet de proxy omite este parámetro, ya que no es compatible con Register-PSResourceRepository.

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

-ProxyCredential

El cmdlet de proxy omite este parámetro, ya que no es compatible con Register-PSResourceRepository.

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

-PublishLocation

El cmdlet de proxy omite este parámetro, ya que no es compatible con Register-PSResourceRepository.

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

-ScriptPublishLocation

El cmdlet de proxy omite este parámetro, ya que no es compatible con Register-PSResourceRepository.

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

-ScriptSourceLocation

El cmdlet de proxy omite este parámetro, ya que no es compatible con Register-PSResourceRepository.

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.

El cmdlet proxy asigna este parámetro al parámetro URI de . Register-PSResourceRepository

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

Entradas

PSCredential

Uri

Salidas

Object

Notas

El Galería de PowerShell ya no admite las versiones 1.0 y 1.1 de Seguridad de la capa de transporte (TLS). Debe usar TLS 1.2 o superior. Use el siguiente comando para asegurarse de que usa TLS 1.2:

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