Register-PSRepository

  • Reference
Modul:
PowerShellGet

Zaregistruje úložiště PowerShellu.

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

Rutina Register-PSRepository zaregistruje výchozí úložiště pro moduly PowerShellu. Po registraci úložiště na něj můžete odkazovat pomocí Find-Modulerutin , Install-Modulea Publish-Module . Zaregistrované úložiště se stane výchozím úložištěm v Find-Module a Install-Module.

Registrovaná úložiště jsou specifická pro uživatele. Nejsou zaregistrované v kontextu celého systému.

Toto je rutina proxy pro rutinu Register-PSResourceRepository v Microsoft.PowerShell.PSResourceGet. Další informace najdete v tématu Register-PSResourceRepository.

Příklady

Příklad 1: Registrace úložiš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

První příkaz zaregistruje https://www.myget.org/F/powershellgetdemo/ jako úložiště pro aktuálního uživatele. Po registraci myNuGetSource na něj můžete explicitně odkazovat při vyhledávání, instalaci a publikování modulů. Vzhledem k tomu, že parametr PackageManagementProvider není zadaný, není úložiště explicitně přidružené k poskytovateli balíčků OneGet, takže PowerShellGet dotazuje dostupné poskytovatele balíčků a přidruží ho k poskytovateli NuGet.

Druhý příkaz získá zaregistrovaná úložiště a zobrazí výsledky.

Parametry

-Credential

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje Register-PSResourceRepository.

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

-Default

Zaregistruje Galerie prostředí PowerShell jako výchozí úložiště.

Rutina proxy transformuje hodnotu tohoto parametru na parametr PSGallery pro Register-PSResourceRepository.

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

-InstallationPolicy

Určuje zásady instalace. Platné hodnoty jsou: Důvěryhodné, Nedůvěryhodné. Výchozí hodnota je Nedůvěryhodná.

Zásady instalace úložiště určují chování PowerShellu při instalaci z tohoto úložiště. Při instalaci modulů z nedůvěryhodného úložiště se uživateli zobrazí výzva k potvrzení.

Rutina proxy transformuje hodnotu tohoto parametru na důvěryhodný parametr pro Register-PSResourceRepository.

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

-Name

Určuje název úložiště, které se má zaregistrovat. Tento název můžete použít k zadání úložiště v rutinách, jako Find-Module jsou a Install-Module.

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

-PackageManagementProvider

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje Register-PSResourceRepository.

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

-Proxy

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje Register-PSResourceRepository.

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

-ProxyCredential

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje Register-PSResourceRepository.

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

-PublishLocation

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje Register-PSResourceRepository.

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

-ScriptPublishLocation

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje Register-PSResourceRepository.

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

-ScriptSourceLocation

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje Register-PSResourceRepository.

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

-SourceLocation

Určuje identifikátor URI pro zjišťování a instalaci modulů z tohoto úložiště. Identifikátorem URI může být serverový informační kanál NuGet (nejběžnější situace), HTTP, HTTPS, FTP nebo umístění souboru.

Například pro úložiště založená na NuGetu je umístění zdroje podobné umístění .https://someNuGetUrl.com/api/v2

Rutina proxy serveru mapuje tento parametr na parametr URIRegister-PSResourceRepository

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

Vstupy

PSCredential

Uri

Výstupy

Object

Poznámky

Galerie prostředí PowerShell už nepodporuje protokol TLS (Transport Layer Security) verze 1.0 a 1.1. Musíte použít protokol TLS 1.2 nebo novější. Pomocí následujícího příkazu se ujistěte, že používáte protokol TLS 1.2:

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