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.

Jest to polecenie cmdlet serwera proxy dla Register-PSResourceRepository polecenia cmdlet w elemecie Microsoft.PowerShell.PSResourceGet. Aby uzyskać więcej informacji, zobacz Register-PSResourceRepository.

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

Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez Register-PSResourceRepositoryprogram .

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

-Default

Rejestruje Galeria programu PowerShell jako domyślne repozytorium.

Polecenie cmdlet serwera proxy przekształca wartość tego parametru na parametr PSGallery polecenia Register-PSResourceRepository.

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.

Polecenie cmdlet serwera proxy przekształca wartość tego parametru na zaufany parametr .Register-PSResourceRepository

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

Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez Register-PSResourceRepositoryprogram .

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

-Proxy

Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez Register-PSResourceRepositoryprogram .

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

-ProxyCredential

Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez Register-PSResourceRepositoryprogram .

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

-PublishLocation

Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez Register-PSResourceRepositoryprogram .

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

-ScriptPublishLocation

Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez Register-PSResourceRepositoryprogram .

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

-ScriptSourceLocation

Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez Register-PSResourceRepositoryprogram .

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.

Polecenie cmdlet serwera proxy mapuje ten parametr na parametr URI polecenia Register-PSResourceRepository

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

Galeria programu PowerShell nie obsługuje już protokołu Transport Layer Security (TLS) w wersji 1.0 i 1.1. Należy użyć protokołu TLS 1.2 lub nowszego. Użyj następującego polecenia, aby upewnić się, że używasz protokołu TLS 1.2:

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