Set-PSResourceRepository

Define informações para um repositório registado.

Sintaxe

Set-PSResourceRepository
   [-Name] <String>
   [-Uri <String>]
   [-Trusted]
   [-Priority <Int32>]
   [-ApiVersion <APIVersion>]
   [-CredentialInfo <PSCredentialInfo>]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-PSResourceRepository
   -Repository <Hashtable[]>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O Set-PSResourceRepository cmdlet define informações para um repositório registado.

Exemplos

Exemplo 1

Neste exemplo, o Uri para o repositório PoshTestGallery foi registado. O Set-PSResourceRepository cmdlet é utilizado para alterar o Uri para um caminho local. O parâmetro PassThru permite-lhe ver o repositório alterado.

Get-PSResourceRepository -Name "PoshTestGallery"

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

Set-PSResourceRepository -Name "PoshTestGallery" -Uri "c:/code/testdir" -PassThru

Name             Uri                                          Trusted   Priority
----             ---                                          -------   --------
PoshTestGallery  file:///c:/code/testdir                        False         50

Exemplo 2

Este exemplo altera os valores Priority e Trusted do repositório.

Nota

O valor URI do repositório PSGallery predefinido não pode ser alterado.

Get-PSResourceRepository -Name "PSGallery"

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

Set-PSResourceRepository -Name "PSGallery" -Priority 25 -Trusted -PassThru

Name             Uri                                          Trusted   Priority
----             ---                                          -------   --------
PSGallery        https://www.powershellgallery.com/api/v2        True         25

Exemplo 3

Este exemplo utiliza o parâmetro Repositório para alterar valores para vários repositórios. O parâmetro utiliza uma matriz de tabelas hash. Cada tabela hash contém informações sobre o repositório que está a ser atualizado.

Get-PSResourceRepository

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

$arrayOfHashtables = @{Name = "PSGallery"; Trusted = $True},
                     @{Name = "PoshTestGallery"; Uri = "c:/code/testdir"}
Set-PSResourceRepository -Repository $arrayOfHashtables -PassThru

Name             Uri                                          Trusted   Priority
----             ---                                          -------   --------
PSGallery        https://www.powershellgallery.com/api/v2        True         50
PoshTestGallery  file:///c:/code/testdir                        False         50

Exemplo 4

Este exemplo atualiza um repositório com informações de credenciais a obter a partir de um cofre Microsoft.PowerShell.SecretManagement registado. Tem de ter o módulo Microsoft.PowerShell.SecretManagement instalado e ter um cofre registado que contenha o segredo armazenado. O formato do segredo tem de corresponder aos requisitos do repositório.

$parameters = @{
  Name = "PoshTestGallery"
  Uri = "c:/code/testdir"
  CredentialInfo = [Microsoft.PowerShell.PowerShellGet.UtilClasses.PSCredentialInfo]::new(
    'SecretStore', 'TestSecret')
}
Set-PSResourceRepository @parameters -PassThru |
    Select-Object * -ExpandProperty CredentialInfo

Name           : PoshTestGallery
Uri            : file:///c:/code/testdir
Trusted        : False
Priority       : 50
CredentialInfo : Microsoft.PowerShell.PowerShellGet.UtilClasses.PSCredentialInfo
VaultName      : SecretStore
SecretName     : TestSecret
Credential     :

Parâmetros

-ApiVersion

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

  • v2 - utiliza a API NuGet V2
  • v3 - utiliza a API NuGet V3
  • local - utilize-o para repositórios baseados no sistema de ficheiros
  • nugetServer - utilize-o para repositórios baseados em NuGet.Server

O Register-PSResourceRepository cmdlet deve detetar automaticamente a versão da API. Este parâmetro permite-lhe alterar a versão da API depois de registar um repositório.

Tipo:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo+APIVersion
Valores aceites:unknown, v2, v3, local, nugetServer
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-CredentialInfo

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

Tipo:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCredentialInfo
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

Especifica o nome do repositório a modificar.

Nota

O valor URI do repositório PSGallery predefinido não pode ser alterado.

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PassThru

Quando especificado, apresenta o repositório registado com êxito e as respetivas informações.

Tipo:SwitchParameter
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Priority

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

Os repositórios são ordenados por prioridade e, em seguida, pelo nome. Ao procurar recursos em vários repositórios, os cmdlets PSResourceGet pesquisam os repositórios com esta sequência de ordenação e devolvem a primeira correspondência encontrada.

Tipo:Int32
Position:Named
Default value:50
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Repository

Especifica uma matriz de tabelas hash que contêm informações do repositório. Utilize este parâmetro para registar vários repositórios ao mesmo tempo. Cada tabela hash só pode ter chaves associadas a parâmetros para NameParameterSet.

Tipo:Hashtable[]
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Trusted

Especifica se o repositório deve ser fidedigno.

Tipo:SwitchParameter
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Uri

Especifica a localização do repositório a registar. O valor tem de utilizar um dos seguintes esquemas de URI:

  • https://
  • http://
  • ftp://
  • file://
Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String

Saídas

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo

Por predefinição, o cmdlet não produz nenhuma saída. Quando utiliza o parâmetro PassThru , o cmdlet devolve um objeto PSRepositoryInfo .