Set-PSResourceRepository
Définit des informations pour un référentiel inscrit.
Syntaxe
NameParameterSet (Par défaut)
Set-PSResourceRepository
[-Name] <String>
[-Uri <String>]
[-Trusted]
[-Priority <Int32>]
[-ApiVersion <APIVersion>]
[-CredentialInfo <PSCredentialInfo>]
[-PassThru]
[-CredentialProvider <CredentialProvider>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
RepositoriesParameterSet
Set-PSResourceRepository
-Repository <Hashtable[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Set-PSResourceRepository définit des informations pour un référentiel inscrit.
Exemples
Exemple 1
Dans cet exemple, le uri Set-PSResourceRepository est utilisée pour modifier l’uri en chemin d’accès local. Le paramètre PassThru vous permet de voir le référentiel 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 référentiel.
Remarque
La valeur
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 référentiel mis à 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 référentiel avec des informations d’identification à récupérer à partir d’un coffre Microsoft.PowerShell.SecretManagement. Vous devez disposer de l’installation du module Microsoft.PowerShell.SecretManagement et disposer d’un coffre inscrit contenant le secret stocké. Le format du secret doit correspondre aux exigences du référentiel.
$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 référentiel. Les valeurs valides sont les suivantes :
-
v2: utilise l’API NuGet V2 -
v3- utilise l’API NuGet V3 -
ContainerRegistry- utilisé pour Azure Container Registry -
local: utilisez-le pour les référentiels basés sur le système de fichiers -
nugetServer: utilisez-le pour les référentiels NuGet.Server
L’applet de commande Register-PSResourceRepository 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 référentiel.
Propriétés des paramètres
| Type: | Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo+APIVersion |
| Valeur par défaut: | None |
| Valeurs acceptées: | V2, V3, Local, NugetServer, ContainerRegistry |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
NameParameterSet
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Confirm
Vous invite à confirmer avant d’exécuter l’applet de commande.
Propriétés des paramètres
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-CredentialInfo
Objet PSCredentialInfo qui inclut le nom d’un coffre et un secret stockés dans un magasin Microsoft.PowerShell.SecretManagement store.
Propriétés des paramètres
| Type: | Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCredentialInfo |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
NameParameterSet
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-CredentialProvider
Il s’agit d’un paramètre dynamique qui spécifie le fournisseur d’accréditations à utiliser pour le dépôt. Ce paramètre n’est disponible que lorsque le dépôt nommé est un flux Azure Artifacts. Les valeurs valides sont les suivantes :
-
None- Aucun fournisseur de crédibilité défini -
AzArtifacts- Utiliser le fournisseur Azure Artifacts Credential
Propriétés des paramètres
| Type: | Microsoft.PowerShell.PSResourceGet.UtilClasses.CredentialProviderType |
| Valeur par défaut: | None |
| Valeurs acceptées: | None, AzArtifacts |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
NameParameterSet
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Name
Spécifie le nom du référentiel à modifier.
Remarque
La valeur
Propriétés des paramètres
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
NameParameterSet
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-PassThru
Une fois spécifié, affiche le référentiel enregistré avec succès et ses informations.
Propriétés des paramètres
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Priority
Spécifie le classement de priorité du référentiel. Les valeurs de priorité valides vont de 0 à 100. Les valeurs inférieures ont un classement de priorité plus élevé. La valeur par défaut est 50.
Les référentiels sont triés par priorité, puis par nom. Lorsque vous recherchez des 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.
Propriétés des paramètres
| Type: | Int32 |
| Valeur par défaut: | 50 |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
NameParameterSet
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Repository
Spécifie un tableau de tables de hachage qui contiennent des informations de référentiel. Utilisez ce paramètre pour inscrire plusieurs référentiels à la fois. Chaque table de hachage ne peut avoir que des clés associées aux paramètres de l'NameParameterSet.
Propriétés des paramètres
| Type: | |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
RepositoriesParameterSet
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Trusted
Spécifie si le référentiel doit être approuvé.
Propriétés des paramètres
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
NameParameterSet
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Uri
Spécifie l’emplacement du référentiel à inscrire. La valeur doit utiliser l’un des schémas d’URI suivants :
https://http://ftp://file://
Propriétés des paramètres
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
NameParameterSet
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.
Propriétés des paramètres
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
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