Register-PSRepository
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-Module
cmdlets , Install-Module
e 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
Saídas
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