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