Compartilhar via

Register-PSRepository

Módulo:
PowerShellGet Module

Registra um repositório do PowerShell.

Sintaxe

Default (Default) 

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 for registrado, você poderá referenciá-lo nos 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 registrados são específicos do usuário. 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 do OneGet foi 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 do 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 for registrado, você poderá referenciá-lo explicitamente 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 Do OneGet, portanto, o PowerShellGet pesquisa 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 Estruturado. O valor padrão é UnTrusted.

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

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Valores aceitos:Trusted, Untrusted
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PackageManagementProvider

Especifica um provedor de pacotes do 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 lidar com o repositório.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PublishLocation

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

Propriedades do parâmetro

Tipo:Uri
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SourceLocation

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

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

Propriedades do parâmetro

Tipo:Uri
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.