Register-PSRepository
Inscrit un référentiel PowerShell.
Syntaxe
Default (Par défaut)
Register-PSRepository
-Name <String>
-SourceLocation <Uri>
[-PublishLocation <Uri>]
[-InstallationPolicy <String>]
[-PackageManagementProvider <String>]
[<CommonParameters>]
Description
L’applet de commande Register-PSRepository inscrit le référentiel par défaut pour les modules PowerShell. Une fois qu’un référentiel est enregistré, vous pouvez le référencer à partir des applets de commande Find-Module, Install-Module et Publish-Module. Le référentiel enregistré devient le référentiel par défaut dans Find-Module et Install-Module.
Les référentiels inscrits sont spécifiques à l’utilisateur. Ils ne sont pas inscrits dans un contexte à l’échelle du système.
Chaque référentiel inscrit est associé à un fournisseur de package OneGet, qui est spécifié avec le paramètre PackageManagementProvider . Chaque fournisseur OneGet est conçu pour interagir avec un type spécifique de référentiel. Par exemple, le fournisseur NuGet est conçu pour interagir avec les référentiels NuGet. Si un fournisseur OneGet n’est pas spécifié lors de l’inscription, PowerShellGet tente de trouver un fournisseur OneGet capable de gérer l’emplacement source spécifié.
Exemples
Exemple 1 : Inscrire un référentiel
PS C:\> Register-PSRepository -Name "myNuGetSource" -SourceLocation "https://www.myget.org/F/powershellgetdemo/api/v2" -PublishLocation "https://www.myget.org/F/powershellgetdemo/api/v2/Packages" -InstallationPolicy Trusted
PS C:\> Get-PSRepository
Name SourceLocation OneGetProvider InstallationPolicy
---- -------------- -------------- ------------------
PSGallery http://go.micro... NuGet Untrusted
myNuGetSource https://myget.c... NuGet Trusted
La première commande s’inscrit https://www.myget.org/F/powershellgetdemo/ en tant que référentiel pour l’utilisateur actuel. Une fois que myNuGetSource est inscrit, vous pouvez le référencer explicitement lors de la recherche, de l’installation et de la publication de modules. Étant donné que le paramètre PackageManagementProvider n’est pas spécifié, le référentiel n’est pas explicitement associé à un fournisseur de package OneGet. PowerShellGet interroge donc les fournisseurs de package disponibles et l’associe au fournisseur NuGet.
La deuxième commande obtient les référentiels inscrits et affiche les résultats.
Paramètres
-InstallationPolicy
Spécifie la stratégie d’installation. Les valeurs valides sont les suivantes : Approuvé, Non approuvé. La valeur par défaut est UnTrusted.
La stratégie d’installation d’un référentiel spécifie le comportement PowerShell lors de l’installation à partir de ce référentiel. Lors de l’installation de modules à partir d’un référentiel non approuvé, l’utilisateur est invité à confirmer.
Vous pouvez définir InstallationPolicy à l’aide de l’applet de commande Set-PSRepository.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Valeurs acceptées: | Trusted, Untrusted |
| 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 |
-Name
Spécifie le nom du référentiel à inscrire. Vous pouvez utiliser ce nom pour spécifier le référentiel dans les applets de commande telles que Find-Module et Install-Module.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-PackageManagementProvider
Spécifie un fournisseur de package OneGet. Si vous ne spécifiez pas de valeur pour ce paramètre, PowerShellGet interroge les fournisseurs de package disponibles et associe ce référentiel au premier fournisseur de package qui indique qu’il peut gérer le référentiel.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| 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 |
-PublishLocation
Spécifie l’URI de l’emplacement de publication. Par exemple, pour les référentiels NuGet, l’emplacement de publication est similaire à http://someNuGetUrl.com/api/v2/Packages.
Propriétés du paramètre
| Type: | Uri |
| Valeur par défaut: | None |
| 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 |
-SourceLocation
Spécifie l’URI permettant de découvrir et d’installer des modules à partir de ce référentiel. Un URI peut être un flux de serveur NuGet (situation la plus courante), HTTP, HTTPS, FTP ou emplacement de fichier.
Par exemple, pour les référentiels NuGet, l’emplacement source est similaire à http://someNuGetUrl.com/api/v2.
Propriétés du paramètre
| Type: | Uri |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| 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.