Compartilhar via

Set-PSResourceRepository

  • Referência
Módulo:
Microsoft.PowerShell.PSResourceGet

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

Syntax

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 registrado.

Exemplos

Exemplo 1

Neste exemplo, o URI do repositório PoshTestGallery foi registrado. O Set-PSResourceRepository cmdlet é usado para alterar o URI para um caminho local. O parâmetro PassThru permite que você veja 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.

Observação

O valor de URI do repositório PSGallery padrão 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 usa o parâmetro Repository para alterar valores para vários repositórios. O parâmetro usa uma matriz de tabelas de hash. Cada tabela de hash contém informações que o repositório está sendo 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 credencial a serem recuperadas de um cofre Microsoft.PowerShell.SecretManagement registrado. Você deve ter o módulo Microsoft.PowerShell.SecretManagement instalado e ter um cofre registrado contendo o segredo armazenado. O formato do segredo deve 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 usada pelo repositório. Os valores válidos são:

  • v2 – usa a API do NuGet V2
  • v3 – usa a API do NuGet V3
  • local – use isso para repositórios baseados no sistema de arquivos
  • nugetServer – use isso para repositórios baseados no NuGet.Server

O Register-PSResourceRepository cmdlet 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.

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo+APIVersion
Accepted values:unknown, v2, v3, local, nugetServer
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CredentialInfo

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

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCredentialInfo
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica o nome do repositório a ser modificado.

Observação

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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.

Type:Int32
Position:Named
Default value:50
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Repository

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

Type:Hashtable[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Trusted

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Uri

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

  • https://
  • http://
  • ftp://
  • file://
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

Saídas

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo

Por padrão, o cmdlet não produz nenhuma saída. Quando você usa o parâmetro PassThru , o cmdlet retorna um objeto PSRepositoryInfo .