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