Partilhar via

Register-PSRepository

Módulo:
PowerShellGet Module

Registra um repositório do PowerShell.

Sintaxe

Default (Predefinição) 

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

Description

O cmdlet Register-PSRepository registra o repositório padrão para módulos do PowerShell. Depois que um repositório é registrado, você pode fazer referência a ele a partir dos cmdlets Find-Module, Install-Module e Publish-Module. O repositório registrado torna-se o repositório padrão em Find-Module e Install-Module.

Os repositórios registados são específicos do utilizador. Eles não são registrados em um contexto de todo o sistema.

Cada repositório registrado é associado a um provedor de pacotes OneGet, que é especificado com o parâmetro PackageManagementProvider. Cada provedor OneGet é projetado para interagir com um tipo específico de repositório. Por exemplo, o provedor NuGet foi projetado para interagir com repositórios baseados em NuGet. Se um provedor OneGet não for especificado durante o registro, o PowerShellGet tentará encontrar um provedor OneGet que possa lidar com o local de origem especificado.

Exemplos

Exemplo 1: Registrar um repositório

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

O primeiro comando registra https://www.myget.org/F/powershellgetdemo/ como um repositório para o usuário atual. Depois que myNuGetSource é registrado, você pode fazer referência explícita a ele ao pesquisar, instalar e publicar módulos. Como o parâmetro PackageManagementProvider não é especificado, o repositório não está explicitamente associado a um provedor de pacotes OneGet, portanto, o PowerShellGet pesquisa os provedores de pacotes disponíveis e o associa ao provedor NuGet.

O segundo comando obtém repositórios registrados e exibe os resultados.

Parâmetros

-InstallationPolicy

Especifica a política de instalação. Os valores válidos são: Confiável, Não Confiável. O valor padrão é UnTrusted.

A política de instalação de um repositório especifica o comportamento do PowerShell ao instalar a partir desse repositório. Ao instalar módulos a partir de um repositório não confiável, o usuário é solicitado a confirmar.

Você pode definir o InstallationPolicy com o cmdlet Set-PSRepository.

Propriedades dos parâmetros

Tipo:String
Default value:None
Valores aceites:Trusted, Untrusted
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

Especifica o nome do repositório a ser registrado. Você pode usar esse nome para especificar o repositório em cmdlets como Find-Module e Install-Module.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PackageManagementProvider

Especifica um provedor de pacote OneGet. Se você não especificar um valor para esse parâmetro, o PowerShellGet sondará os provedores de pacotes disponíveis e associará esse repositório ao primeiro provedor de pacotes que indica que ele pode manipular o repositório.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PublishLocation

Especifica o URI do local de publicação. Por exemplo, para repositórios baseados em NuGet, o local de publicação é semelhante ao http://someNuGetUrl.com/api/v2/Packages.

Propriedades dos parâmetros

Tipo:Uri
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-SourceLocation

Especifica o URI para descobrir e instalar módulos a partir deste repositório. Um URI pode ser um feed de servidor NuGet (situação mais comum), HTTP, HTTPS, FTP ou local de arquivo.

Por exemplo, para repositórios baseados em NuGet, o local de origem é semelhante ao http://someNuGetUrl.com/api/v2.

Propriedades dos parâmetros

Tipo:Uri
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.