Register-PSResourceRepository

Sintaxe

NameParameterSet (Default)

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-o para repositórios baseados no sistema de arquivos
• NugetServer – use-o para repositórios baseados em NuGet.Server

O cmdlet Register-PSResourceRepository deve detectar 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 do parâmetro

Conjuntos de parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Propriedades do parâmetro

Conjuntos de parâmetros

-CredentialInfo

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

Propriedades do parâmetro

Conjuntos de parâmetros

-CredentialProvider

Este é um parâmetro dinâmico que especifica o provedor de credenciais a ser usado para o repositório. Esse parâmetro só está disponível quando o repositório registrado for um feed Azure Artifats. Os valores válidos são:

• None - Nenhum provedor de credencial definido
• AzArtifacts - Use o Provedor de Credenciais de Artefatos Azure

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

Propriedades do parâmetro

Conjuntos de parâmetros

-Force

Substituirá um repositório se ele já existir.

Propriedades do parâmetro

Conjuntos de parâmetros

-MicrosoftArtifactRegistry

Quando especificado, registra o repositório padrão MicrosoftArtifactRegistry com as seguintes configurações:

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

Por padrão, o MicrosoftArtifactRegistry repositório é registrado como um repositório confiável com prioridade maior que o repositório PSGallery .

Você não pode usar esse parâmetro para resetar o repositório existente. Use Set-PSResourceRepository para alterar as configurações do repositório existente.

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

Propriedades do parâmetro

Conjuntos de parâmetros

-Name

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

Propriedades do parâmetro

Conjuntos de parâmetros

-PassThru

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

Propriedades do parâmetro

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 padrão é 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 do parâmetro

Conjuntos de parâmetros

-PSGallery

Quando especificado, registra o repositório padrão PSGallery com as seguintes configurações:

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

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

Você pode usar isso para restaurar o registro padrão do PSGallery repositório caso ele tenha sido removido. Você não pode usar esse parâmetro para resetar o repositório existente. Use Set-PSResourceRepository para alterar as configurações do repositório existente.

Propriedades do parâmetro

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 ao mesmo tempo. Cada hashtable só pode ter chaves associadas a parâmetros para o NameParameterSet ou o PSGalleryParameterSet.

Propriedades do parâmetro

Conjuntos de parâmetros

-Trusted

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

Propriedades do parâmetro

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 do parâmetro

Conjuntos de parâmetros

-WhatIf

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

Propriedades do parâmetro

Conjuntos de parâmetros

CommonParameters

Entradas

None

Saídas

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo

Observações

Links Relacionados

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