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.