Register-PSResourceRepository

Sintaxe

NameParameterSet (Predefinição)

Register-PSResourceRepository
    [-Name] <string>
    [-Uri] <string>
    [-Trusted]
    [-Priority <int>]
    [-ApiVersion <PSRepositoryInfo+APIVersion>]
    [-CredentialInfo <PSCredentialInfo>]
    [-CredentialProvider <CredentialProvider>]
    [-PassThru]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

PSGalleryParameterSet

Register-PSResourceRepository
    -PSGallery
    [-Trusted]
    [-Priority <int>]
    [-PassThru]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

MARParameterSet

Register-PSResourceRepository
    -MicrosoftArtifactRegistry
    [-Trusted]
    [-Priority <int>]
    [-PassThru]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RepositoriesParameterSet

Register-PSResourceRepository
    -Repository <hashtable[]>
    [-PassThru]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Exemplos

Exemplo 1

Register-PSResourceRepository -Name PoshTestGallery -Uri 'https://www.poshtestgallery.com/api/v2'
Get-PSResourceRepository -Name PoshTestGallery

Name             Uri                                          Trusted   Priority
----             ---                                          -------   --------
PoshTestGallery  https://www.poshtestgallery.com/api/v2         False         50

Exemplo 2

Register-PSResourceRepository -PSGallery
Get-PSResourceRepository -Name 'PSGallery'

Name             Uri                                          Trusted   Priority
----             ---                                          -------   --------
PSGallery        https://www.powershellgallery.com/api/v2       False         50

Exemplo 3

$arrayOfHashtables = @{
        Name = 'Local'
        Uri = 'D:/PSRepoLocal/'
        Trusted = $true
        Priority = 20
    },
    @{
        Name = 'PSGv3'
        Uri = 'https://www.powershellgallery.com/api/v3'
        Trusted = $true
        Priority = 50
    },
    @{
        PSGallery = $true
        Trusted = $true
        Priority = 10
    }
Register-PSResourceRepository -Repository $arrayOfHashtables
Get-PSResourceRepository

Name      Uri                                      Trusted Priority
----      ---                                      ------- --------
PSGallery https://www.powershellgallery.com/api/v2 True    10
Local     file:///D:/PSRepoLocal/                  True    20
PSGv3     https://www.powershellgallery.com/api/v3 True    50

Exemplo 4

$parameters = @{
  Name = 'PSGv3'
  Uri = 'https://www.powershellgallery.com/api/v3'
  Trusted = $true
  Priority = 50
  CredentialInfo = [Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCredentialInfo]::new(
    'SecretStore', 'TestSecret')
}
Register-PSResourceRepository @parameters
Get-PSResourceRepository | Select-Object * -ExpandProperty CredentialInfo

Name           : PSGv3
Uri            : https://www.powershellgallery.com/api/v3
Trusted        : True
Priority       : 50
CredentialInfo : Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCredentialInfo
VaultName      : SecretStore
SecretName     : TestSecret
Credential     :

Parâmetros

-ApiVersion

Especifica a versão da API usada pelo repositório. Os valores válidos são:

• V2 - usa a API do NuGet V2
• V3 - usa a API do NuGet V3
• ContainerRegistry - usado para o Registro de Contêiner do Azure
• Local - use isso para repositórios baseados em sistema de arquivos
• NugetServer - use isso para repositórios baseados em NuGet.Server

O cmdlet Register-PSResourceRepository deve detetar automaticamente a versão da API. Esse parâmetro permite que você altere a versão da API depois de registrar um repositório.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Conjuntos de parâmetros

-CredentialInfo

Um objeto de PSCredentialInfo que inclui o nome de um cofre e um segredo armazenado em um armazenamento Microsoft.PowerShell.SecretManagement.

Propriedades dos parâmetros

Conjuntos de parâmetros

-CredentialProvider

Este é um parâmetro dinâmico que especifica o fornecedor de credenciais a usar para o repositório. Este parâmetro só está disponível quando o repositório registado é um feed Artefactos do Azure. Os valores válidos são:

• None - Nenhum fornecedor de credenciais definido
• AzArtifacts - Utilizar o Fornecedor de Credenciais de Artefactos Azure

Se não usar este parâmetro, o valor padrão é None. Se a URL do repositório contiver pkgs.dev.azure.com ou pkgs.visualstudio.com, o comando regista automaticamente o repositório com a propriedade CredentialProvider definida para AzArtifacts.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Force

Substitui um repositório se ele já existir.

Propriedades dos parâmetros

Conjuntos de parâmetros

-MicrosoftArtifactRegistry

Quando especificado, regista o repositório predefinido MicrosoftArtifactRegistry com as seguintes definições:

• Name - MicrosoftArtifactRegistry
• Uri - https://mcr.microsoft.com/
• Trusted - Verdade
• Priority - 40
• ApiVersion - ContainerRegistry

Por defeito, o MicrosoftArtifactRegistry repositório é registado como um repositório Confiável com prioridade superior à do repositório PSGallery .

Não podes usar este parâmetro para reiniciar o repositório existente. Use Set-PSResourceRepository para alterar as definições do repositório existente.

Este parâmetro foi adicionado na Microsoft. PowerShell.PSResourceGet v1.3.0-preview1.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Name

Nome do repositório a registar. Não pode ser PSGallery nem MicrosoftArtifactRegistry.

Propriedades dos parâmetros

Conjuntos de parâmetros

-PassThru

Quando especificado, exibe o repositório registrado com êxito e suas informações.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Priority

Especifica a classificação de prioridade do repositório. Os valores de prioridade válidos variam de 0 a 100. Valores mais baixos têm uma classificação de prioridade mais alta. O valor predefinido é 50.

Os repositórios são classificados por prioridade e, em seguida, por nome. Ao pesquisar recursos em vários repositórios, os cmdlets PSResourceGet pesquisam os repositórios usando essa ordem de classificação e retornam a primeira correspondência encontrada.

Propriedades dos parâmetros

Conjuntos de parâmetros

-PSGallery

Quando especificado, regista o repositório predefinido PSGallery com as seguintes definições:

• Name - PSGallery
• Uri - https://www.powershellgallery.com/api/v2
• Trusted - Falso
• Priority - 50
• ApiVersion - V2

Por defeito, o PSGallery repositório é registado como um repositório Não Confiável com uma prioridade inferior à do repositório MicrosoftArtifactRegistry .

Podes usar isto para restaurar o registo padrão do PSGallery repositório se este tiver sido removido. Não podes usar este parâmetro para reiniciar o repositório existente. Use Set-PSResourceRepository para alterar as definições do repositório existente.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Repository

Especifica uma matriz de hashtables que contêm informações do repositório. Use esse parâmetro para registrar vários repositórios de uma só vez. Cada hashtable só pode ter chaves associadas a parâmetros para o NameParameterSet ou o PSGalleryParameterSet.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Trusted

Especifica se o repositório deve ser confiável.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Uri

Especifica o local do repositório a ser registrado. O valor deve usar um dos seguintes esquemas de URI:

• https://
• http://
• ftp://
• file://

Propriedades dos parâmetros

Conjuntos de parâmetros

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades dos parâmetros

Conjuntos de parâmetros

CommonParameters

Entradas

None

Saídas

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo

Notas

Ligações Relacionadas

• Microsoft.PowerShell.SecretManagement
• Get-PSResourceRepository
• Set-PSResourceRepository
• Reset-PSResourceRepository
• Unregister-PSResourceRepository