Freigeben über

Register-PSRepository

  • Referenz
Modul:
PowerShellGet

Registriert ein PowerShell-Repository.

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

Beschreibung

Das Register-PSRepository Cmdlet registriert das Standard-Repository für PowerShell-Module. Nachdem ein Repository registriert wurde, können Sie darauf über die Find-ModuleCmdlets Install-Moduleund Publish-Module die Datei verweisen. Das registrierte Repository wird zum Standard-Repository in Find-Module und Install-Module.

Registrierte Repositorys sind benutzerspezifisch. Sie werden nicht in einem systemweiten Kontext registriert.

Dies ist ein Proxy-Cmdlet für das Register-PSResourceRepository Cmdlet in microsoft.PowerShell.PSResourceGet. Weitere Informationen finden Sie unter Register-PSResourceRepository.

Beispiele

Beispiel 1: Registrieren eines Repositorys

$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

Der erste Befehl registriert https://www.myget.org/F/powershellgetdemo/ sich als Repository für den aktuellen Benutzer. Nachdem myNuGetSource registriert wurde, können Sie explizit darauf verweisen, wenn Sie nach Modulen suchen, installieren und veröffentlichen. Da der Parameter "PackageManagementProvider " nicht angegeben ist, ist das Repository nicht explizit einem OneGet-Paketanbieter zugeordnet, daher fragt PowerShellGet verfügbare Paketanbieter ab und ordnet es dem NuGet-Anbieter zu.

Der zweite Befehl ruft registrierte Repositorys ab und zeigt die Ergebnisse an.

Parameter

-Credential

Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht unterstützt wird Register-PSResourceRepository.

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Default

Registriert den PowerShell-Katalog als Standard-Repository.

Das Proxy-Cmdlet transformiert den Wert dieses Parameters in den PSGallery-Parameter von Register-PSResourceRepository.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InstallationPolicy

Gibt die Installationsrichtlinie an. Gültige Werte sind: Vertrauenswürdig, nicht vertrauenswürdig. Der Standardwert ist "Nicht Vertrauenswürdig".

Die Installationsrichtlinie eines Repositorys gibt das PowerShell-Verhalten bei der Installation aus diesem Repository an. Beim Installieren von Modulen aus einem nicht vertrauenswürdigen Repository wird der Benutzer zur Bestätigung aufgefordert.

Das Proxy-Cmdlet transformiert den Wert dieses Parameters in den Trusted-Parameter von Register-PSResourceRepository.

Typ:String
Zulässige Werte:Trusted, Untrusted
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen des zu registrierenden Repositorys an. Sie können diesen Namen verwenden, um das Repository in Cmdlets wie Find-Module z. B. und Install-Module.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PackageManagementProvider

Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht unterstützt wird Register-PSResourceRepository.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Proxy

Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht unterstützt wird Register-PSResourceRepository.

Typ:Uri
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ProxyCredential

Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht unterstützt wird Register-PSResourceRepository.

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PublishLocation

Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht unterstützt wird Register-PSResourceRepository.

Typ:Uri
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ScriptPublishLocation

Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht unterstützt wird Register-PSResourceRepository.

Typ:Uri
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ScriptSourceLocation

Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht unterstützt wird Register-PSResourceRepository.

Typ:Uri
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SourceLocation

Gibt den URI zum Ermitteln und Installieren von Modulen aus diesem Repository an. Ein URI kann ein NuGet-Serverfeed (häufigste Situation), HTTP, HTTPS, FTP oder Dateispeicherort sein.

Bei NuGet-basierten Repositorys ist der Quellspeicherort z. B. ähnlich https://someNuGetUrl.com/api/v2.

Das Proxy-Cmdlet ordnet diesen Parameter dem URI-Parameter zu. Register-PSResourceRepository

Typ:Uri
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

PSCredential

Uri

Ausgaben

Object

Hinweise

Der PowerShell-Katalog unterstützt die Tls-Versionen 1.0 und 1.1 nicht mehr. Sie müssen TLS 1.2 oder höher verwenden. Verwenden Sie den folgenden Befehl, um sicherzustellen, dass Sie TLS 1.2 verwenden:

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