Compartilhar via


Register-PSRepository

Registra um repositório do PowerShell.

Sintaxe

NameParameterSet (Padrã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 for registrado, você poderá referenciá-lo dos Find-Modulecmdlets e Install-Module do cmdletsPublish-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.

Este é um cmdlet proxy para o Register-PSResourceRepository cmdlet no Microsoft.PowerShell.PSResourceGet. Para obter mais informações, consulte Register-PSResourceRepository.

Exemplos

Exemplo 1: registrar um repositório

$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

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

-Credential

O cmdlet de proxy ignora esse parâmetro, pois ele não tem suporte Register-PSResourceRepository.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-Default

Registra a Galeria do PowerShell como o repositório padrão.

O cmdlet de proxy transforma o valor desse parâmetro para o parâmetro PSGallery de Register-PSResourceRepository.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-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.

O cmdlet de proxy transforma o valor desse parâmetro no parâmetro Trusted de Register-PSResourceRepository.

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

NameParameterSet
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PackageManagementProvider

O cmdlet de proxy ignora esse parâmetro, pois ele não tem suporte Register-PSResourceRepository.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-Proxy

O cmdlet de proxy ignora esse parâmetro, pois ele não tem suporte Register-PSResourceRepository.

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

-ProxyCredential

O cmdlet de proxy ignora esse parâmetro, pois ele não tem suporte Register-PSResourceRepository.

Propriedades do parâmetro

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

-PublishLocation

O cmdlet de proxy ignora esse parâmetro, pois ele não tem suporte Register-PSResourceRepository.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-ScriptPublishLocation

O cmdlet de proxy ignora esse parâmetro, pois ele não tem suporte Register-PSResourceRepository.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-ScriptSourceLocation

O cmdlet de proxy ignora esse parâmetro, pois ele não tem suporte Register-PSResourceRepository.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

O cmdlet de proxy mapeia esse parâmetro para o parâmetro Uri de Register-PSResourceRepository

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

Entradas

PSCredential

Uri

Saídas

Object

Observações

A Galeria do PowerShell não dá mais suporte a TLS (Transport Layer Security) versões 1.0 e 1.1. Você deve usar o TLS 1.2 ou superior. Use o seguinte comando para garantir que você esteja usando o TLS 1.2:

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