Partager via


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 du référentiel PoshTestGallery a été inscrit. L’applet de commande 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 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 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 Uri du référentiel PSGallery par défaut ne peut pas être modifiée.

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:

Hashtable[]

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 , l’applet de commande retourne un objet PSRepositoryInfo.