Condividi tramite


Set-PSResourceRepository

Imposta le informazioni per un repository registrato.

Sintassi

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

Descrizione

Il Set-PSResourceRepository cmdlet imposta informazioni per un repository registrato.

Esempio

Esempio 1

In questo esempio è stato registrato l'URI per il repository PoshTestGallery . Il Set-PSResourceRepository cmdlet viene usato per modificare l'URI in un percorso locale. Il parametro PassThru consente di visualizzare il repository modificato.

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

Esempio 2

In questo esempio vengono modificati i valori Priority e Trusted del repository.

Nota

Non è possibile modificare il valore URI del repository PSGallery predefinito.

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

Esempio 3

In questo esempio viene usato il parametro Repository per modificare i valori per più repository. Il parametro accetta una matrice di tabelle hash. Ogni tabella hash contiene informazioni sull'aggiornamento del repository.

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

Esempio 4

In questo esempio viene aggiornato un repository con informazioni sulle credenziali da recuperare da un insieme di credenziali Microsoft.PowerShell.SecretManagement registrato. È necessario installare il modulo Microsoft.PowerShell.SecretManagement e disporre di un insieme di credenziali registrato contenente il segreto archiviato. Il formato del segreto deve corrispondere ai requisiti del repository.

$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     :

Parametri

-ApiVersion

Specifica la versione dell'API usata dal repository. I valori validi sono:

  • v2 - usa l'API NuGet V2
  • v3 - usa l'API NuGet V3
  • local - usare questo per i repository basati su file system
  • nugetServer - usare questa opzione per i repository basati su NuGet.Server

Il Register-PSResourceRepository cmdlet deve rilevare automaticamente la versione dell'API. Questo parametro consente di modificare la versione dell'API dopo aver registrato un repository.

Tipo:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo+APIVersion
Valori accettati:unknown, v2, v3, local, nugetServer
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CredentialInfo

Oggetto PSCredentialInfo che include il nome di un insieme di credenziali e un segreto archiviato in un archivio Microsoft.PowerShell.SecretManagement .

Tipo:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCredentialInfo
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specifica il nome del repository da modificare.

Nota

Non è possibile modificare il valore URI del repository PSGallery predefinito.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PassThru

Se specificato, visualizza il repository registrato correttamente e le relative informazioni.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Priority

Specifica la classificazione di priorità del repository. I valori di priorità validi sono compresi tra 0 e 100. I valori inferiori hanno una classificazione di priorità superiore. Il valore predefinito è 50.

I repository vengono ordinati in base alla priorità e quindi in base al nome. Quando si cercano risorse in più repository, i cmdlet PSResourceGet ricercano i repository usando questo ordine di ordinamento e restituiscono la prima corrispondenza trovata.

Tipo:Int32
Posizione:Named
Valore predefinito:50
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Repository

Specifica una matrice di tabelle hash che contengono informazioni sul repository. Usare questo parametro per registrare più repository contemporaneamente. Ogni tabella hash può avere solo chiavi associate ai parametri per NameParameterSet.

Tipo:Hashtable[]
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Trusted

Specifica se il repository deve essere attendibile.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Uri

Specifica il percorso del repository da registrare. Il valore deve usare uno degli schemi URI seguenti:

  • https://
  • http://
  • ftp://
  • file://
Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

String

Output

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo

Per impostazione predefinita, il cmdlet non produce alcun output. Quando si usa il parametro PassThru , il cmdlet restituisce un oggetto PSRepositoryInfo .