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 Standardrepository für PowerShell-Module. Nachdem ein Repository registriert wurde, können Sie über die Find-ModuleCmdlets , Install-Moduleund Publish-Module darauf verweisen. Das registrierte Repository wird zum Standardrepository in Find-Module und Install-Module.

Registrierte Repositorys sind benutzerspezifisch. Sie sind 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. Der NuGet-Anbieter ist beispielsweise 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 wird https://www.myget.org/F/mypsrepository/ als Repository für den aktuellen Benutzer registriert. Nachdem myNuGetSource registriert wurde, können Sie beim Suchen, Installieren und Veröffentlichen von Modulen explizit darauf verweisen. Da der Parameter PackageManagementProvider nicht angegeben ist, ist das Repository nicht explizit einem OneGet-Paketanbieter zugeordnet, sodass PowerShellGet verfügbare Paketanbieter abruft und dem NuGet-Anbieter ordnet.

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

Parameter

-Credential

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

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

-Default

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

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

Type:String
Accepted values:Trusted, Untrusted
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 er das Repository verarbeiten kann.

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

-Proxy

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

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

-ProxyCredential

Gibt ein Benutzerkonto an, das über die Berechtigung zur Verwendung des Proxyservers verfügt, der durch den Proxy-Parameter angegeben wird.

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

-PublishLocation

Gibt den URI des Veröffentlichungsorts für Module an. Für NuGet-basierte Repositorys ähnelt https://someNuGetUrl.com/api/v2/packageder Veröffentlichungsort beispielsweise .

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

-ScriptPublishLocation

Gibt den URI des Veröffentlichungsorts für Skripts an. Für NuGet-basierte Repositorys ähnelt https://someNuGetUrl.com/api/v2/package/der Veröffentlichungsort beispielsweise .

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

Für NuGet-basierte Repositorys ähnelt https://someNuGetUrl.com/api/v2/items/psscriptder Quellspeicherort beispielsweise .

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

Für NuGet-basierte Repositorys ähnelt https://someNuGetUrl.com/api/v2der Quellspeicherort beispielsweise .

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

Eingaben

PSCredential

Uri

Ausgaben

Object

Hinweise

Wichtig

Ab April 2020 unterstützt der PowerShell-Katalog die TLS-Versionen (Transport Layer Security) 1.0 und 1.1 nicht mehr. Wenn Sie nicht TLS 1.2 oder höher verwenden, erhalten Sie beim Versuch des Zugriffs auf den PowerShell-Katalog eine Fehlermeldung. Mit dem folgenden Befehl können Sie sicherstellen, dass Sie TLS 1.2 verwenden:

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

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