Freigeben über


Install-PackageProvider

Installiert einen oder mehrere Paketverwaltungspaketanbieter.

Syntax

PackageBySearch (Standardwert)

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

PackageByInputObject

Install-PackageProvider
    [-InputObject] <SoftwareIdentity[]>
    [-Scope <String>]
    [-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.

Parametereigenschaften

Typ:SwitchParameter
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:False
Wert aus verbleibenden Argumenten:False

-Confirm

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

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

-Credential

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

Parametereigenschaften

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

Parametersätze

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

Parametereigenschaften

Typ:SwitchParameter
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:False
Wert aus verbleibenden Argumenten:False

-ForceBootstrap

Gibt an, dass dieses Cmdlet den Paketanbieter automatisch installiert.

Parametereigenschaften

Typ:SwitchParameter
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:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:

Microsoft.PackageManagement.Packaging.SoftwareIdentity[]

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

Parametersätze

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

Parametereigenschaften

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

Parametersätze

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

Parametereigenschaften

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

Parametersätze

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

-Name

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

Parametereigenschaften

Typ:

String[]

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

Parametersätze

PackageBySearch
Position:0
Obligatorisch.:True
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:False
Wert aus verbleibenden Argumenten:False

-ProxyCredential

Gibt ein Benutzerkonto an, das über die Berechtigung zum Verwenden des Proxyservers verfügt, der durch den Parameter Proxy 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:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

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

Parametersätze

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

Parametereigenschaften

Typ:String
Standardwert:None
Zulässige Werte:CurrentUser, AllUsers
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

-Source

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

Parametereigenschaften

Typ:

String[]

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

Parametersätze

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

-WhatIf

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch.:False
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

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

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.