Set-PSResourceRepository

Définit les informations d’un dépôt inscrit.

Syntaxe

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

L’applet Set-PSResourceRepository de commande définit les informations d’un dépôt inscrit.

Exemples

Exemple 1

Dans cet exemple, l’URI du dépôt PoshTestGallery a été inscrit. L’applet Set-PSResourceRepository de commande est utilisée pour remplacer l’URI par un chemin d’accès local. Le paramètre PassThru vous permet de voir le dépôt modifié.

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

Exemple 2

Cet exemple montre comment modifier les valeurs Priority et Trusted du dépôt.

Notes

La valeur URI du référentiel PSGallery par défaut ne peut pas être modifiée.

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

Exemple 3

Cet exemple utilise le paramètre Repository pour modifier les valeurs de plusieurs référentiels. Le paramètre prend un tableau de tables de hachage. Chaque table de hachage contient des informations sur le dépôt en cours de mise à jour.

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

Exemple 4

Cet exemple met à jour un dépôt avec des informations d’identification à récupérer à partir d’un coffre Microsoft.PowerShell.SecretManagement inscrit. Vous devez installer le module Microsoft.PowerShell.SecretManagement et disposer d’un coffre inscrit contenant le secret stocké. Le format du secret doit correspondre aux exigences du dépôt.

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

Paramètres

-ApiVersion

Spécifie la version de l’API utilisée par le dépôt. Les valeurs autorisées sont :

  • v2 - utilise l’API NuGet V2
  • v3 - utilise l’API NuGet V3
  • local - utilisez-le pour les référentiels basés sur le système de fichiers
  • nugetServer - utilisez-le pour les référentiels basés sur NuGet.Server

L’applet Register-PSResourceRepository de commande doit détecter automatiquement la version de l’API. Ce paramètre vous permet de modifier la version de l’API après avoir inscrit un dépôt.

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo+APIVersion
Valeurs acceptées:unknown, v2, v3, local, nugetServer
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CredentialInfo

Objet PSCredentialInfo qui inclut le nom d’un coffre et un secret stockés dans un magasin Microsoft.PowerShell.SecretManagement .

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCredentialInfo
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie le nom du dépôt à modifier.

Notes

La valeur URI du référentiel PSGallery par défaut ne peut pas être modifiée.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-PassThru

Lorsque cette option est spécifiée, affiche le dépôt correctement inscrit et ses informations.

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Priority

Spécifie le classement de priorité du dépôt. Les valeurs de priorité valides sont comprises entre 0 et 100. Les valeurs inférieures ont un classement de priorité plus élevé. La valeur par défaut est 50.

Les dépôts sont triés par priorité, puis par nom. Lors de la recherche de ressources dans plusieurs référentiels, les applets de commande PSResourceGet recherchent les référentiels à l’aide de cet ordre de tri et retournent la première correspondance trouvée.

Type:Int32
Position:Named
Valeur par défaut:50
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Repository

Spécifie un tableau de tables de hachage qui contiennent des informations de dépôt. Utilisez ce paramètre pour inscrire plusieurs référentiels à la fois. Chaque table de hachage peut uniquement avoir des clés associées aux paramètres pour nameParameterSet.

Type:Hashtable[]
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Trusted

Spécifie si le dépôt doit être approuvé.

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Uri

Spécifie l’emplacement du dépôt à inscrire. La valeur doit utiliser l’un des schémas d’URI suivants :

  • https://
  • http://
  • ftp://
  • file://
Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

String

Sorties

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo

Par défaut, l’applet de commande ne produit aucune sortie. Lorsque vous utilisez le paramètre PassThru , l’applet de commande renvoie un objet PSRepositoryInfo .