Register-PSRepository
Rejestruje repozytorium programu PowerShell.
Składnia
NameParameterSet (Domyślnie)
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>]
Opis
Polecenie Register-PSRepository cmdlet rejestruje domyślne repozytorium modułów programu PowerShell. Po zarejestrowaniu repozytorium można odwoływać się do niego z Find-Modulepoleceń cmdlet , Install-Modulei Publish-Module . Zarejestrowane repozytorium staje się domyślnym repozytorium w systemach Find-Module i Install-Module.
Zarejestrowane repozytoria są specyficzne dla użytkownika. Nie są one zarejestrowane w kontekście całego systemu.
Każde zarejestrowane repozytorium jest skojarzone z dostawcą pakietów OneGet, który jest określony z parametrem PackageManagementProvider. Każdy dostawca OneGet jest przeznaczony do interakcji z określonym typem repozytorium. Na przykład dostawca NuGet jest przeznaczony do interakcji z repozytoriami opartymi na nuGet. Jeśli podczas rejestracji nie określono dostawcy OneGet, program PowerShellGet próbuje znaleźć dostawcę OneGet, który może obsłużyć określoną lokalizację źródłową.
Przykłady
Przykład 1. Rejestrowanie repozytorium
$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
Pierwsze polecenie rejestruje https://www.myget.org/F/mypsrepository/ jako repozytorium dla bieżącego użytkownika. Po zarejestrowaniu elementu myNuGetSource można je jawnie odwołać podczas wyszukiwania, instalowania i publikowania modułów. Ponieważ parametr PackageManagementProvider nie jest określony, repozytorium nie jest jawnie skojarzone z dostawcą pakietów OneGet, dlatego program PowerShellGet sonduje dostępnych dostawców pakietów i kojarzy go z dostawcą NuGet.
Drugie polecenie pobiera zarejestrowane repozytoria i wyświetla wyniki.
Parametry
-Credential
Określa poświadczenia konta, które ma uprawnienia do rejestrowania repozytorium.
Właściwości parametrów
| Typ: | PSCredential |
| Wartość domyślna: | None |
| Obsługuje symbole wieloznaczne: | False |
| Nie pokaż: | False |
Zestawy parametrów
NameParameterSet
| Pozycja: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-Default
Parametr służy do rejestrowania galerii PSGallery. Należy to zrobić tylko wtedy, gdy usunięto repozytorium PSGallery .
Właściwości parametrów
| Typ: | SwitchParameter |
| Wartość domyślna: | None |
| Obsługuje symbole wieloznaczne: | False |
| Nie pokaż: | False |
Zestawy parametrów
PSGalleryParameterSet
| Pozycja: | Named |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-InstallationPolicy
Określa zasady instalacji. Prawidłowe wartości to: Zaufane, Niezaufane. Wartość domyślna to UnTrusted.
Zasady instalacji repozytorium określają zachowanie programu PowerShell podczas instalowania z tego repozytorium. Podczas instalowania modułów z repozytorium UnTrusted użytkownik jest monitowany o potwierdzenie.
Zasady instalacji można ustawić za Set-PSRepository pomocą polecenia cmdlet .
Właściwości parametrów
| Typ: | String |
| Wartość domyślna: | None |
| Akceptowane wartości: | Trusted, Untrusted |
| Obsługuje symbole wieloznaczne: | False |
| Nie pokaż: | False |
Zestawy parametrów
(All)
| Pozycja: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Name
Określa nazwę repozytorium do zarejestrowania. Możesz użyć tej nazwy, aby określić repozytorium w poleceniach cmdlet, takich jak Find-Module i Install-Module.
Właściwości parametrów
| Typ: | String |
| Wartość domyślna: | None |
| Obsługuje symbole wieloznaczne: | False |
| Nie pokaż: | False |
Zestawy parametrów
NameParameterSet
| Pozycja: | 0 |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-PackageManagementProvider
Określa dostawcę pakietów OneGet. Jeśli nie określisz wartości dla tego parametru, program PowerShellGet sonduje dostępnych dostawców pakietów i kojarzy to repozytorium z pierwszym dostawcą pakietów, który wskazuje, że może obsłużyć repozytorium.
Właściwości parametrów
| Typ: | String |
| Wartość domyślna: | None |
| Obsługuje symbole wieloznaczne: | False |
| Nie pokaż: | False |
Zestawy parametrów
NameParameterSet
| Pozycja: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Proxy
Określa serwer proxy dla żądania, zamiast łączyć się bezpośrednio z zasobem internetowym.
Właściwości parametrów
| Typ: | Uri |
| Wartość domyślna: | None |
| Obsługuje symbole wieloznaczne: | False |
| Nie pokaż: | False |
Zestawy parametrów
(All)
| Pozycja: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-ProxyCredential
Określa konto użytkownika, które ma uprawnienia do korzystania z serwera proxy określonego przez parametr proxy .
Właściwości parametrów
| Typ: | PSCredential |
| Wartość domyślna: | None |
| Obsługuje symbole wieloznaczne: | False |
| Nie pokaż: | False |
Zestawy parametrów
(All)
| Pozycja: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-PublishLocation
Określa identyfikator URI lokalizacji publikowania dla modułów. Na przykład w przypadku repozytoriów opartych na pakietach NuGet lokalizacja publikowania jest podobna do https://someNuGetUrl.com/api/v2/package.
Właściwości parametrów
| Typ: | Uri |
| Wartość domyślna: | None |
| Obsługuje symbole wieloznaczne: | False |
| Nie pokaż: | False |
Zestawy parametrów
NameParameterSet
| Pozycja: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-ScriptPublishLocation
Określa identyfikator URI lokalizacji publikowania dla skryptów. Na przykład w przypadku repozytoriów opartych na pakietach NuGet lokalizacja publikowania jest podobna do https://someNuGetUrl.com/api/v2/package/.
Właściwości parametrów
| Typ: | Uri |
| Wartość domyślna: | None |
| Obsługuje symbole wieloznaczne: | False |
| Nie pokaż: | False |
Zestawy parametrów
NameParameterSet
| Pozycja: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-ScriptSourceLocation
Określa identyfikator URI do odnajdywania i instalowania skryptów z tego repozytorium. Identyfikator URI może być źródłem danych serwera NuGet (najbardziej typową sytuacją), http, HTTPS, FTP lub lokalizacją pliku.
Na przykład w przypadku repozytoriów opartych na nuGet lokalizacja źródłowa jest podobna do https://someNuGetUrl.com/api/v2/items/psscript.
Właściwości parametrów
| Typ: | Uri |
| Wartość domyślna: | None |
| Obsługuje symbole wieloznaczne: | False |
| Nie pokaż: | False |
Zestawy parametrów
NameParameterSet
| Pozycja: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-SourceLocation
Określa identyfikator URI do odnajdywania i instalowania modułów z tego repozytorium. Identyfikator URI może być źródłem danych serwera NuGet (najbardziej typową sytuacją), http, HTTPS, FTP lub lokalizacją pliku.
Na przykład w przypadku repozytoriów opartych na nuGet lokalizacja źródłowa jest podobna do https://someNuGetUrl.com/api/v2.
Właściwości parametrów
| Typ: | Uri |
| Wartość domyślna: | None |
| Obsługuje symbole wieloznaczne: | False |
| Nie pokaż: | False |
Zestawy parametrów
NameParameterSet
| Pozycja: | 1 |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Wejścia
PSCredential
Uri
Wyjść
Object
Notatki
Ważne
Od kwietnia 2020 r. galeria programu PowerShell nie obsługuje już protokołu Transport Layer Security (TLS) w wersji 1.0 i 1.1. Jeśli nie używasz protokołu TLS 1.2 lub nowszego, podczas próby uzyskania dostępu do galerii programu PowerShell zostanie wyświetlony błąd. Użyj następującego polecenia, aby upewnić się, że używasz protokołu TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Aby uzyskać więcej informacji, zobacz anons w blogu programu PowerShell.
