Udostępnij za pośrednictwem

Register-PSRepository

  • Odwołanie
Moduł:
PowerShellGet

Rejestruje repozytorium programu PowerShell.

Składnia

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>]

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 określonym za pomocą parametru 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 dostawca OneGet nie zostanie określony podczas rejestracji, 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/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

Pierwsze polecenie rejestruje https://www.myget.org/F/powershellgetdemo/ się jako repozytorium dla bieżącego użytkownika. Po zarejestrowaniu elementu myNuGetSource można jawnie odwoływać się do niej 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 moduł PowerShellGet sonduje dostępnych dostawców pakietów i kojarzy je 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.

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

-Default

Parametr służy do rejestrowania galerii PSGallery. Należy to zrobić tylko w przypadku usunięcia repozytorium PSGallery .

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 .

Type:String
Accepted values:Trusted, Untrusted
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-PackageManagementProvider

Określa dostawcę pakietu 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.

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

-Proxy

Określa serwer proxy dla żądania, zamiast łączyć się bezpośrednio z zasobem internetowym.

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

-ProxyCredential

Określa konto użytkownika, które ma uprawnienia do korzystania z serwera proxy, który jest określony przez parametr proxy .

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

-PublishLocation

Określa identyfikator URI lokalizacji publikowania. Na przykład w przypadku repozytoriów opartych na programie NuGet lokalizacja publikowania jest podobna do https://someNuGetUrl.com/api/v2/Packages.

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

-ScriptPublishLocation

Określa lokalizację publikowania skryptu.

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

-ScriptSourceLocation

Określa lokalizację źródłową skryptu.

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

-SourceLocation

Określa identyfikator URI odnajdywania i instalowania modułów z tego repozytorium. Identyfikator URI może być źródłem danych serwera NuGet (najczęściej występującym sytuacją), http, HTTPS, FTP lub lokalizacją pliku.

Na przykład w przypadku repozytoriów opartych na programie NuGet lokalizacja źródłowa jest podobna do https://someNuGetUrl.com/api/v2.

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

Dane wejściowe

PSCredential

Uri

Dane wyjściowe

Object

Uwagi

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 Galeria 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 ogłoszenie w blogu programu PowerShell.