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

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

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

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

-CredentialInfo

Oggetto PSCredentialInfo che include il nome di un insieme di credenziali e un segreto archiviato in un archivio 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

Specifica il nome del repository da modificare.

Nota

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

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

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32
Position:Named
Default value:50
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-Trusted

Specifica se il repository deve essere attendibile.

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

-Uri

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

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .