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