Partilhar via

Register-PSRepository

Módulo:
PowerShellGet Module

Registra um repositório do PowerShell.

Sintaxe

NameParameterSet (Predefinição) 

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

PSGalleryParameterSet 

Register-PSRepository
    [-Default]
    [-InstallationPolicy <String>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [<CommonParameters>]

Description

O Register-PSRepository cmdlet 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 Find-Modulepartir dos cmdlets , Install-Modulee 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

$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

O primeiro comando registra https://www.myget.org/F/mypsrepository/ 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

-Credential

Especifica as credenciais de uma conta que tem direitos para registrar um repositório.

Propriedades dos parâmetros

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

Conjuntos de parâmetros

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

-Default

O parâmetro é usado para registrar o PSGallery. Você só precisa fazer isso se tiver removido o repositório PSGallery .

Propriedades dos parâmetros

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

Conjuntos de parâmetros

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

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

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

NameParameterSet
Position:0
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

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

-Proxy

Especifica um servidor proxy para a solicitação, em vez de se conectar diretamente ao recurso da Internet.

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:True
Valor dos restantes argumentos:False

-ProxyCredential

Especifica uma conta de usuário que tem permissão para usar o servidor proxy especificado pelo parâmetro Proxy .

Propriedades dos parâmetros

Tipo:PSCredential
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:True
Valor dos restantes argumentos:False

-PublishLocation

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

Propriedades dos parâmetros

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

Conjuntos de parâmetros

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

-ScriptPublishLocation

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

Propriedades dos parâmetros

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

Conjuntos de parâmetros

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

-ScriptSourceLocation

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

Propriedades dos parâmetros

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

Conjuntos de parâmetros

NameParameterSet
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 https://someNuGetUrl.com/api/v2.

Propriedades dos parâmetros

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

Conjuntos de parâmetros

NameParameterSet
Position:1
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.

Entradas

PSCredential

Uri

Saídas

Object

Notas

Importante

A partir de abril de 2020, a Galeria do PowerShell não suporta mais as versões 1.0 e 1.1 do Transport Layer Security (TLS). Se você não estiver usando o TLS 1.2 ou superior, receberá um erro ao tentar acessar a Galeria do PowerShell. Use o seguinte comando para garantir que você esteja usando o TLS 1.2:

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

Para obter mais informações, consulte o de anúncio de no blog do PowerShell.