Install-PackageProvider

Installiert mindestens einen 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 bei PowerShellGet registrierten Paketquellen verfügbar sind. Standardmäßig umfasst dies Module, die im Windows PowerShell-Katalog mit dem Tag PackageManagement verfügbar sind. Der PowerShellGet-Paketverwaltungsanbieter wird verwendet, um Anbieter in diesen Repositorys zu finden.

Dieses Cmdlet installiert auch übereinstimmende Paketverwaltungsanbieter, die über die Bootstrappinganwendung für die Paketverwaltung verfügbar sind.

Dieses Cmdlet installiert auch übereinstimmende Paketverwaltungsanbieter, die im Azure-Blobspeicher für die Paketverwaltung verfügbar sind. Verwenden Sie den Bootstrapperanbieter, um sie zu finden und zu installieren.

Um das erste Mal auszuführen, erfordert PackageManagement eine Internetverbindung zum Herunterladen des NuGet-Paketanbieters. Wenn Ihr Computer jedoch keine Internetverbindung hat und Sie den NuGet- oder PowerShellGet-Anbieter verwenden müssen, können Sie sie auf einen anderen Computer herunterladen und auf Ihren Zielcomputer kopieren. Führen Sie hierzu die folgenden Schritte aus:

  1. Führen Sie aus Install-PackageProvider -Name NuGet -RequiredVersion 2.8.5.201 -Force , um den Anbieter von einem Computer mit Internetverbindung zu installieren.
  2. Nach der Installation finden Sie den Anbieter, der in $env:ProgramFiles\PackageManagement\ProviderAssemblies\<ProviderName>\<ProviderVersion> oder $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies\<ProviderName>\<ProviderVersion>installiert ist.
  3. Platzieren Sie den <ProviderName> Ordner, in diesem Fall der NuGet-Ordner, am entsprechenden Speicherort auf Ihrem Zielcomputer. Wenn Es sich bei Ihrem Zielcomputer um einen Nano-Server handelt, müssen Sie von Nano Server aus ausführen Install-PackageProvider , um die richtigen NuGet-Binärdateien herunterzuladen.
  4. Starten Sie PowerShell neu, um den Paketanbieter automatisch zu laden. Führen Sie alternativ aus Get-PackageProvider -ListAvailable , um alle auf dem Computer verfügbaren Paketanbieter aufzulisten. Verwenden Sie Import-PackageProvider -Name NuGet -RequiredVersion 2.8.5.201 dann , um den Anbieter in die aktuelle Windows PowerShell-Sitzung zu importieren.

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 sucht alle Versionen des Paketanbieters mit dem Namen NuGet. Mit dem zweiten Befehl wird eine angegebene Version des NuGet-Paketanbieters installiert.

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

Beispiel 3: Suchen und Installieren eines Anbieters

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 installiert, damit $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies nur der aktuelle Benutzer ihn verwenden kann.

Install-PackageProvider -Name GistProvider -Verbose -Scope CurrentUser

Parameter

-AllVersions

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

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

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

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

-Force

Gibt an, dass dieses Cmdlet alle Aktionen mit diesem Cmdlet erzwingt, die erzwungen werden können. Derzeit bedeutet dies, dass der Force-Parameter genauso wie der ForceBootstrap-Parameter fungiert.

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

-ForceBootstrap

Gibt an, dass dieses Cmdlet den Paketanbieter automatisch installiert.

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

-InputObject

Gibt ein SoftwareIdentity-Objekt an . Verwenden Sie das Find-PackageProvider Cmdlet, um ein SoftwareIdentity-Objekt abzurufen, das an übergeben werden Install-PackageProvidersoll.

Type:Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MaximumVersion

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

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

-MinimumVersion

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

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

-Name

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

Type:String[]
Position:0
Default value:None
Required:True
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:False
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:False
Accept wildcard characters:False

-RequiredVersion

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

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

-Scope

Gibt den Installationsbereich des Anbieters an. Zulässige Werte für diesen Parameter:

  • 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 Ort, an dem nur der aktuelle Benutzer darauf zugreifen kann. Standardmäßig ist dies $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies.

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

-Source

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

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Sie können ein SoftwareIdentity-Objekt an dieses Cmdlet übergeben. Verwenden Sie Find-PackageProvider , um ein SoftwareIdentity-Objekt abzurufen, das in Install-PackageProviderübergeben werden kann.

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.