Register-PSRepository

  • Référence
Module:
PowerShellGet

Inscrit un dépôt PowerShell.

Syntax

Register-PSRepository
        [-Name] <String>
        [-SourceLocation] <Uri>
        [-PublishLocation <Uri>]
        [-ScriptSourceLocation <Uri>]
        [-ScriptPublishLocation <Uri>]
        [-Credential <PSCredential>]
        [-InstallationPolicy <String>]
        [-Proxy <Uri>]
        [-ProxyCredential <PSCredential>]
        [-PackageManagementProvider <String>]
        [<CommonParameters>]
Register-PSRepository
        [-Default]
        [-InstallationPolicy <String>]
        [-Proxy <Uri>]
        [-ProxyCredential <PSCredential>]
        [<CommonParameters>]

Description

L’applet Register-PSRepository de commande inscrit le référentiel par défaut pour les modules PowerShell. Une fois qu’un dépôt est inscrit, vous pouvez le référencer à partir des Find-Moduleapplets de commande , Install-Moduleet Publish-Module . Le dépôt inscrit devient le référentiel par défaut dans Find-Module et Install-Module.

Les référentiels enregistrés sont spécifiques à l’utilisateur. Ils ne sont pas enregistrés dans un contexte à l’échelle du système.

Il s’agit d’une applet de commande de proxy pour l’applet Register-PSResourceRepository de commande dans Microsoft.PowerShell.PSResourceGet. Pour plus d’informations, consultez Register-PSResourceRepository.

Exemples

Exemple 1 : Inscrire un dépôt

$parameters = @{
  Name = "myNuGetSource"
  SourceLocation = "https://www.myget.org/F/powershellgetdemo/api/v2"
  PublishLocation = "https://www.myget.org/F/powershellgetdemo/api/v2/Packages"
  InstallationPolicy = 'Trusted'
}
Register-PSRepository @parameters
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 myNuGetSource 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 dépôt n’est pas explicitement associé à un fournisseur de package OneGet. PowerShellGet interroge donc les fournisseurs de packages disponibles et l’associe au fournisseur NuGet.

La deuxième commande obtient les dépôts inscrits et affiche les résultats.

Paramètres

-Credential

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par Register-PSResourceRepository.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Default

Inscrit PowerShell Gallery en tant que référentiel par défaut.

L’applet de commande proxy transforme la valeur de ce paramètre en paramètre PSGallery de Register-PSResourceRepository.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InstallationPolicy

Spécifie la stratégie d’installation. Les valeurs valides sont : Approuvé, Non approuvé. La valeur par défaut est UnTrusted.

La stratégie d’installation d’un dépôt spécifie le comportement de PowerShell lors de l’installation à partir de ce dépôt. Lors de l’installation de modules à partir d’un dépôt non approuvé, l’utilisateur est invité à confirmer.

L’applet de commande proxy transforme la valeur de ce paramètre en paramètre Approuvé de Register-PSResourceRepository.

Type:String
Accepted values:Trusted, Untrusted
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Spécifie le nom du dépôt à inscrire. Vous pouvez utiliser ce nom pour spécifier le dépôt dans des applets de commande telles que Find-Module et Install-Module.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PackageManagementProvider

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par Register-PSResourceRepository.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Proxy

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par Register-PSResourceRepository.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ProxyCredential

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par Register-PSResourceRepository.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PublishLocation

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par Register-PSResourceRepository.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ScriptPublishLocation

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par Register-PSResourceRepository.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ScriptSourceLocation

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par Register-PSResourceRepository.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceLocation

Spécifie l’URI permettant de découvrir et d’installer des modules à partir de ce dépôt. Un URI peut être un flux de serveur NuGet (situation la plus courante), HTTP, HTTPS, FTP ou un emplacement de fichier.

Par exemple, pour les dépôts basés sur NuGet, l’emplacement source est similaire à https://someNuGetUrl.com/api/v2.

L’applet de commande proxy mappe ce paramètre au paramètre URI de Register-PSResourceRepository

Type:Uri
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Entrées

PSCredential

Uri

Sorties

Object

Notes

Le PowerShell Gallery ne prend plus en charge les versions TLS (Transport Layer Security) 1.0 et 1.1. Vous devez utiliser TLS 1.2 ou version ultérieure. Utilisez la commande suivante pour vous assurer que vous utilisez TLS 1.2 :

[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12