Register-PSRepository
Registra 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 registra o repositório padrão para módulos do PowerShell. Depois que um repositório for registrado, você poderá referenciá-lo dos Find-Module
cmdlets , Install-Module
e Publish-Module
. O repositório registrado torna-se o repositório padrão em Find-Module
e Install-Module
.
Repositórios registrados são específicos ao usuário. Eles não são registrados em um contexto de todo o sistema.
Cada repositório registrado está 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
$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 se 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 está especificado, o repositório não está explicitamente associado a um provedor de pacotes 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
Especifica as credenciais de uma conta que tem direitos para registrar um repositório.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Default
O parâmetro é usado para registrar o PSGallery. Você só precisará fazer isso se tiver removido o repositório PSGallery .
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: 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 Set-PSRepository
cmdlet .
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 ser registrado. Você pode usar esse 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
Especifica um provedor de pacotes 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Proxy
Especifica um servidor proxy para a solicitação, em vez de se conectar diretamente ao recurso da Internet.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ProxyCredential
Especifica uma conta de usuário com permissão para conectar-se aos computadores especificados pelo parâmetro Proxy.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 https://someNuGetUrl.com/api/v2/Packages
.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScriptPublishLocation
Especifica o local de publicação do script.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScriptSourceLocation
Especifica o local de origem do script.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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
.
Type: | Uri |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Saídas
Observações
Importante
A partir de abril de 2020, a Galeria do PowerShell não dará mais suporte às versões 1.0 e 1.1 do protocolo TLS. Se você não estiver usando o TLS 1.2 ou posterior, receberá um erro ao tentar acessar a Galeria do PowerShell. Use o seguinte comando para garantir que esteja usando o TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Para obter mais informações, confira o comunicado no blog do PowerShell.