Freigeben über

Register-PSRepository

Modul:
PowerShellGet Module

Registriert ein PowerShell-Repository.

Syntax

NameParameterSet (Standard) 

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

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.

Jedes registrierte Repository ist einem OneGet-Paketanbieter zugeordnet, der mit dem parameter PackageManagementProvider angegeben wird. Jeder OneGet-Anbieter ist für die Interaktion mit einem bestimmten Repositorytyp konzipiert. Beispielsweise ist der NuGet-Anbieter für die Interaktion mit NuGet-basierten Repositorys konzipiert. Wenn während der Registrierung kein OneGet-Anbieter angegeben wird, versucht PowerShellGet, einen OneGet-Anbieter zu finden, der den angegebenen Quellspeicherort verarbeiten kann.

Beispiele

Beispiel 1: Registrieren eines Repositorys

$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

Der erste Befehl registriert https://www.myget.org/F/mypsrepository/ 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 PackageManagementProvider Parameter nicht angegeben ist, ist das Repository nicht explizit einem OneGet-Paketanbieter zugeordnet, sodass PowerShellGet verfügbare Paketanbieter abruft und dem NuGet-Anbieter zuordnet.

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

Parameter

-Credential

Gibt Anmeldeinformationen eines Kontos an, das über Berechtigungen zum Registrieren eines Repositorys verfügt.

Parametereigenschaften

Typ:PSCredential
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

NameParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Default

Der Parameter wird verwendet, um die PSGallery zu registrieren. Sie müssen dies nur tun, wenn Sie das PSGallery-Repository entfernt haben.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

PSGalleryParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Sie können die InstallationPolicy mit dem Set-PSRepository Cmdlet festlegen.

Parametereigenschaften

Typ:String
Standardwert:None
Zulässige Werte:Trusted, Untrusted
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

NameParameterSet
Position:0
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PackageManagementProvider

Gibt einen OneGet-Paketanbieter an. Wenn Sie keinen Wert für diesen Parameter angeben, fragt PowerShellGet verfügbare Paketanbieter ab und ordnet dieses Repository dem ersten Paketanbieter zu, der angibt, dass es das Repository verarbeiten kann.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

NameParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Proxy

Gibt einen Proxyserver für die Anforderung an, anstatt eine direkte Verbindung mit der Internetressource herzustellen.

Parametereigenschaften

Typ:Uri
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ProxyCredential

Gibt ein Benutzerkonto an, das über die Berechtigung zum Verwenden des Proxyservers verfügt, der durch den Proxyparameter angegeben wird.

Parametereigenschaften

Typ:PSCredential
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-PublishLocation

Gibt den URI des Veröffentlichungsorts für Module an. Bei NuGet-basierten Repositorys ähnelt https://someNuGetUrl.com/api/v2/packageder Veröffentlichungsspeicherort z. B. .

Parametereigenschaften

Typ:Uri
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

NameParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ScriptPublishLocation

Gibt den URI des Veröffentlichungsorts für Skripts an. Bei NuGet-basierten Repositorys ähnelt https://someNuGetUrl.com/api/v2/package/der Veröffentlichungsspeicherort z. B. .

Parametereigenschaften

Typ:Uri
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

NameParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ScriptSourceLocation

Gibt den URI zum Ermitteln und Installieren von Skripts 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/items/psscript.

Parametereigenschaften

Typ:Uri
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

NameParameterSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:Uri
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

NameParameterSet
Position:1
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

PSCredential

Uri

Ausgaben

Object

Hinweise

Von Bedeutung

Ab April 2020 unterstützt der PowerShell-Katalog die Tls-Versionen 1.0 und 1.1 nicht mehr. Wenn Sie TLS 1.2 oder höher nicht verwenden, wird beim Versuch, auf den PowerShell-Katalog zuzugreifen, eine Fehlermeldung angezeigt. Verwenden Sie den folgenden Befehl, um sicherzustellen, dass Sie TLS 1.2 verwenden:

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

Weitere Informationen finden Sie in der Ankündigung im PowerShell-Blog.