Install-PackageProvider

Modul:: PackageManagement

Installiert einen oder mehrere Paketverwaltungspaketanbieter.

Syntax

Install-PackageProvider
       [-Name] <String[]>
       [-RequiredVersion <String>]
       [-MinimumVersion <String>]
       [-MaximumVersion <String>]
       [-Credential <PSCredential>]
       [-Scope <String>]
       [-Source <String[]>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Install-PackageProvider
       [-Scope <String>]
       [-InputObject] <SoftwareIdentity[]>
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Beschreibung

Das Install-PackageProvider Cmdlet installiert übereinstimmende Paketverwaltungsanbieter, die in Paketquellen verfügbar sind, die mit PowerShellGet registriert sind. Standardmäßig enthält dies Module, die im Windows PowerShell-Katalog mit dem PackageManagement-Tag verfügbar sind. Der PowerShellGet-Paketverwaltungsanbieter wird für die Suche nach Anbietern in diesen Repositorys verwendet.

Mit diesem Cmdlet werden auch übereinstimmende Paketverwaltungsanbieter installiert, die mithilfe der Bootstrapping-Anwendung für die Paketverwaltung verfügbar sind.

Beispiele

Beispiel 1: Installieren eines Paketanbieters aus dem PowerShell-Katalog

Mit diesem Befehl wird der GistProvider-Paketanbieter aus dem PowerShell-Katalog installiert.

Install-PackageProvider -Name "GistProvider" -Verbose

Beispiel 2: Installieren einer angegebenen Version eines Paketanbieters

In diesem Beispiel wird eine angegebene Version des NuGet-Paketanbieters installiert.

Der erste Befehl findet alle Versionen des Paketanbieters mit dem Namen NuGet. Der zweite Befehl installiert eine angegebene Version des NuGet-Paketanbieters.

Find-PackageProvider -Name "NuGet" -AllVersions
Install-PackageProvider -Name "NuGet" -RequiredVersion "2.8.5.216" -Force

Sie müssen den NuGet-Paketanbieter nur installieren, wenn Sie PackageManagement v1.1.0.0 in Windows PowerShell ausführen. Neuere Versionen von PowerShellGet und PackageManagement enthalten standardmäßig den NuGet-Paketanbieter.

Beispiel 3: Suchen eines Anbieters und Installieren

In diesem Beispiel wird Find-PackageProvider und die Pipeline verwendet, um nach dem Gist-Anbieter zu suchen und zu installieren.

Find-PackageProvider -Name "GistProvider" | Install-PackageProvider -Verbose

Beispiel 4: Installieren eines Anbieters im Modulordner des aktuellen Benutzers

Mit diesem Befehl wird ein Paketanbieter $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies installiert, sodass nur der aktuelle Benutzer es verwenden kann.

Install-PackageProvider -Name GistProvider -Verbose -Scope CurrentUser

Parameter

-AllVersions

Gibt an, dass dieses Cmdlet alle verfügbaren Versionen des Paketanbieters installiert. Gibt standardmäßig Install-PackageProvider nur die höchste verfügbare Version zurück.

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

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Credential

Gibt ein Benutzerkonto an, das über die Berechtigung zum Installieren von Paketanbietern verfügt.

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

-Force

Gibt an, dass dieses Cmdlet alle Aktionen mit diesem Cmdlet erzwingt, die erzwungen werden können. Derzeit bedeutet dies, dass der Parameter "Force " mit dem Parameter "ForceBootstrap " identisch ist.

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

-ForceBootstrap

Gibt an, dass dieses Cmdlet den Paketanbieter automatisch installiert.

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

-InputObject

Gibt ein SoftwareIdentity -Objekt an. Verwenden Sie das Find-PackageProvider Cmdlet, um ein SoftwareIdentity-Objekt abzurufen, in das sie weitergeleitet Install-PackageProviderwerden können.

Typ:	Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-MaximumVersion

Gibt die maximal zulässige Version des Paketanbieters an, die Sie installieren möchten. Wenn Sie diesen Parameter nicht hinzufügen, Install-PackageProvider wird die höchste verfügbare Version des Anbieters installiert.

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

-MinimumVersion

Gibt die mindestens zulässige Version des Paketanbieters an, die Sie installieren möchten. Wenn Sie diesen Parameter nicht hinzufügen, wird die höchste verfügbare Version des Pakets installiert, Install-PackageProvider die auch alle vom MaximumVersion-Parameter angegebenen Anforderungen erfüllt.

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

-Name

Gibt einen oder mehrere Paketanbietermodulnamen an. Trennen Sie mehrere Paketnamen durch Kommas. Platzhalterzeichen werden nicht unterstützt.

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

-Proxy

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

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

-ProxyCredential

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

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

-RequiredVersion

Gibt die genaue zulässige Version des Paketanbieters an, die Sie installieren möchten. Wenn Sie diesen Parameter nicht hinzufügen, wird die höchste verfügbare Version des Anbieters installiert, Install-PackageProvider die auch die maximale Version erfüllt, die durch den Parameter MaximumVersion angegeben wird.

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

-Scope

Gibt den Installationsumfang des Anbieters an. Die zulässigen Werte für diesen Parameter sind:

AllUsers : Installiert Anbieter an einem Speicherort, auf den alle Benutzer des Computers zugreifen können. Standardmäßig ist dies $env:ProgramFiles\PackageManagement\ProviderAssemblies.
CurrentUser : Installiert Anbieter an einem Speicherort, an dem sie nur für den aktuellen Benutzer zugänglich sind. Standardmäßig ist dies $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies.

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

-Source

Gibt eine oder mehrere Paketquellen an. Verwenden Sie das Get-PackageSource Cmdlet, um eine Liste der verfügbaren Paketquellen abzurufen.

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

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Sie können ein SoftwareIdentity-Objekt an dieses Cmdlet weiterleiten. Dient Find-PackageProvider zum Abrufen eines SoftwareIdentity-Objekts , das weitergeleitet Install-PackageProviderwerden kann.

Hinweise

Wichtig

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.

Freigeben über