Condividi tramite

Set-PSResourceRepository

  • Riferimento
Modulo:
Microsoft.PowerShell.PSResourceGet

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 cmdlet Set-PSResourceRepository imposta le informazioni per un repository registrato.

Esempio

Esempio 1

In questo esempio è stata registrata la URI di per il repository PoshTestGallery. Il cmdlet viene usato per modificare il URI di 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 Trusted del repository.

Nota

Non è possibile modificare il valore URI predefinito 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 sul repository da aggiornare.

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 registrato Microsoft.PowerShell.SecretManagement vault. È necessario che sia installato il modulo Microsoft.PowerShell.SecretManagement e che sia presente 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
  • ContainerRegistry : usato per Registro Azure Container
  • local : usare questa opzione per i repository basati su file system
  • nugetServer: usare questa opzione per i repository basati su NuGet.Server

Il cmdlet Register-PSResourceRepository dovrebbe 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:V2, V3, Local, NugetServer, ContainerRegistry
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede conferma 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 predefinito 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 della priorità del repository. I valori di priorità validi sono compresi tra 0 e 100. I valori inferiori hanno una classificazione con priorità più alta. 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 di PSResourceGet eseguono ricerche nei repository usando questo 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 chiavi associate solo ai parametri per il 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 considerato 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 cosa accadrebbe se il cmdlet viene eseguito. 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

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.