Share via

Register-PSRepository

  • Referência
Módulo:
PowerShellGet

Regista um repositório do 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

O Register-PSRepository cmdlet regista o repositório predefinido para módulos do PowerShell. Depois de um repositório ser registado, pode referenciá-lo a partir dos Find-Modulecmdlets , Install-Modulee Publish-Module . O repositório registado torna-se o repositório predefinido em Find-Module e Install-Module.

Os repositórios registados são específicos do utilizador. Não estão registados num contexto ao nível do sistema.

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

Exemplos

Exemplo 1: Registar 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 é registado https://www.myget.org/F/powershellgetdemo/ como um repositório para o utilizador atual. Depois de o myNuGetSource estar registado, pode referenciá-lo explicitamente ao procurar, instalar e publicar módulos. Uma vez que o parâmetro PackageManagementProvider não está especificado, o repositório não está explicitamente associado a um fornecedor de pacotes OneGet, pelo que o PowerShellGet consulta os fornecedores de pacotes disponíveis e associa-o ao fornecedor NuGet.

O segundo comando obtém os repositórios registados e apresenta os resultados.

Parâmetros

-Credential

O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo Register-PSResourceRepository.

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

-Default

Regista Galeria do PowerShell como o repositório predefinido.

O cmdlet proxy transforma o valor deste parâmetro no 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 a política de instalação. Os valores válidos são: Fidedigno, Não Fidedigno. O valor predefinido é 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 Fidedido, é pedida confirmação ao utilizador.

O cmdlet proxy transforma o valor deste parâmetro no 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 o nome do repositório a registar. Pode utilizar este nome para especificar o repositório em cmdlets como Find-Module e Install-Module.

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

-PackageManagementProvider

O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo Register-PSResourceRepository.

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

-Proxy

O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo Register-PSResourceRepository.

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

-ProxyCredential

O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo Register-PSResourceRepository.

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

-PublishLocation

O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo Register-PSResourceRepository.

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

-ScriptPublishLocation

O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo Register-PSResourceRepository.

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

-ScriptSourceLocation

O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo Register-PSResourceRepository.

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

-SourceLocation

Especifica o URI para detetar 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 localização de ficheiro.

Por exemplo, para repositórios baseados em NuGet, a localização de origem é semelhante a https://someNuGetUrl.com/api/v2.

O cmdlet proxy mapeia este parâmetro para o 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

Saídas

Object

Notas

O Galeria do PowerShell já não suporta as versões 1.0 e 1.1 do Transport Layer Security (TLS). Tem de utilizar o TLS 1.2 ou superior. Utilize o seguinte comando para garantir que está a utilizar o TLS 1.2:

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