Register-PSRepository
Zaregistruje úložiště PowerShellu.
Syntax
NameParameterSet (Výchozí)
Register-PSRepository
[-Name] <String>
[-SourceLocation] <Uri>
[-PublishLocation <Uri>]
[-ScriptSourceLocation <Uri>]
[-ScriptPublishLocation <Uri>]
[-Credential <PSCredential>]
[-InstallationPolicy <String>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-PackageManagementProvider <String>]
[<CommonParameters>]
PSGalleryParameterSet
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 z Find-ModuleInstall-Modulerutin a 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.
Každé registrované úložiště je přidruženo k poskytovateli balíčku OneGet, který je určen parametrem PackageManagementProvider . Každý zprostředkovatel OneGet je navržený tak, aby pracoval s konkrétním typem úložiště. Například zprostředkovatel NuGet je navržený pro interakci s úložišti založenými na NuGetu. Pokud není během registrace zadán zprostředkovatel OneGet, PowerShellGet se pokusí najít zprostředkovatele OneGet, který dokáže zpracovat zadané umístění zdroje.
Příklady
Příklad 1: Registrace úložiště
$parameters = @{
Name = "myNuGetSource"
SourceLocation = "https://www.myget.org/F/mypsrepository/api/v2"
PublishLocation = "https://www.myget.org/F/mypsrepository/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 se zaregistruje https://www.myget.org/F/mypsrepository/ jako úložiště pro aktuálního uživatele. Po registraci myNuGetSource můžete na něj explicitně odkazovat při hledání, instalaci a publikování modulů. Protože parametr PackageManagementProvider není zadaný, úložiště není explicitně přidruženo k poskytovateli balíčku OneGet, takže PowerShellGet se dotazuje dostupných poskytovatelů balíčků a přidruží ho k poskytovateli NuGet.
Druhý příkaz získá zaregistrovaná úložiště a zobrazí výsledky.
Parametry
-Credential
Určuje přihlašovací údaje účtu, který má práva k registraci úložiště.
Vlastnosti parametru
| Typ: | PSCredential |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
NameParameterSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Default
Parametr se používá k registraci PSGallery. Stačí to udělat jenom v případě, že jste odebrali úložiště PSGallery .
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
PSGalleryParameterSet
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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í.
InstalačníPolicy můžete nastavit pomocí rutinySet-PSRepository.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Přípustné hodnoty: | Trusted, Untrusted |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Name
Určuje název úložiště, které se má zaregistrovat. Tento název můžete použít k určení úložiště v rutinách, jako Find-Module je například a Install-Module.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
NameParameterSet
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-PackageManagementProvider
Určuje zprostředkovatele balíčku OneGet. Pokud pro tento parametr nezadáte hodnotu, PowerShellGet se dotazuje dostupných zprostředkovatelů balíčků a přidruží toto úložiště k prvnímu poskytovateli balíčku, který označuje, že toto úložiště dokáže zpracovat.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
NameParameterSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Proxy
Určuje proxy server pro požadavek místo přímého připojení k internetovému prostředku.
Vlastnosti parametru
| Typ: | Uri |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-ProxyCredential
Určuje uživatelský účet, který má oprávnění používat proxy server určený parametrem Proxy.
Vlastnosti parametru
| Typ: | PSCredential |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-PublishLocation
Určuje identifikátor URI umístění publikování pro moduly. Například pro úložiště založená na NuGetu je umístění publikování podobné https://someNuGetUrl.com/api/v2/package.
Vlastnosti parametru
| Typ: | Uri |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
NameParameterSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-ScriptPublishLocation
Určuje identifikátor URI umístění publikování pro skripty. Například pro úložiště založená na NuGetu je umístění publikování podobné https://someNuGetUrl.com/api/v2/package/.
Vlastnosti parametru
| Typ: | Uri |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
NameParameterSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-ScriptSourceLocation
Určuje identifikátor URI pro zjišťování a instalaci skriptů z tohoto úložiště. Identifikátor URI může být informační kanál serveru NuGet (nejběžnější situace), HTTP, HTTPS, FTP nebo umístění souboru.
Například pro úložiště založená na NuGetu je zdrojové umístění podobné https://someNuGetUrl.com/api/v2/items/psscript.
Vlastnosti parametru
| Typ: | Uri |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
NameParameterSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-SourceLocation
Určuje identifikátor URI pro zjišťování a instalaci modulů z tohoto úložiště. Identifikátor URI může být informační kanál serveru NuGet (nejběžnější situace), HTTP, HTTPS, FTP nebo umístění souboru.
Například pro úložiště založená na NuGetu je zdrojové umístění podobné https://someNuGetUrl.com/api/v2.
Vlastnosti parametru
| Typ: | Uri |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
NameParameterSet
| Position: | 1 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
PSCredential
Uri
Výstupy
Object
Poznámky
Důležité
Od dubna 2020 galerie Prostředí PowerShell už nepodporuje protokol TLS (Transport Layer Security) verze 1.0 a 1.1. Pokud nepoužíváte protokol TLS 1.2 nebo vyšší, při pokusu o přístup k galerii Prostředí PowerShell se zobrazí chyba. Pomocí následujícího příkazu se ujistěte, že používáte protokol TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Další informace najdete v oznámení v blogu PowerShellu.
