Freigeben über


Install-Package

Installiert mindestens ein Softwarepaket.

Syntax

Install-Package
       [-Name] <String[]>
       [-RequiredVersion <String>]
       [-MinimumVersion <String>]
       [-MaximumVersion <String>]
       [-Source <String[]>]
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-ProviderName <String[]>]
       [<CommonParameters>]
Install-Package
       [-InputObject] <SoftwareIdentity[]>
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-ConfigFile <String>]
       [-SkipValidate]
       [-Headers <String[]>]
       [-FilterOnTag <String[]>]
       [-Contains <String>]
       [-AllowPrereleaseVersions]
       [-Destination <String>]
       [-ExcludeVersion]
       [-Scope <String>]
       [-SkipDependencies]
       [<CommonParameters>]
Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-ConfigFile <String>]
       [-SkipValidate]
       [-Headers <String[]>]
       [-FilterOnTag <String[]>]
       [-Contains <String>]
       [-AllowPrereleaseVersions]
       [-Destination <String>]
       [-ExcludeVersion]
       [-Scope <String>]
       [-SkipDependencies]
       [<CommonParameters>]
Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-AllowPrereleaseVersions]
       [-Scope <String>]
       [-PackageManagementProvider <String>]
       [-PublishLocation <String>]
       [-ScriptSourceLocation <String>]
       [-ScriptPublishLocation <String>]
       [-Type <String>]
       [-Filter <String>]
       [-Tag <String[]>]
       [-Includes <String[]>]
       [-DscResource <String[]>]
       [-RoleCapability <String[]>]
       [-Command <String[]>]
       [-AcceptLicense]
       [-AllowClobber]
       [-SkipPublisherCheck]
       [-InstallUpdate]
       [-NoPathUpdate]
       [<CommonParameters>]
Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-AllowPrereleaseVersions]
       [-Scope <String>]
       [-PackageManagementProvider <String>]
       [-PublishLocation <String>]
       [-ScriptSourceLocation <String>]
       [-ScriptPublishLocation <String>]
       [-Type <String>]
       [-Filter <String>]
       [-Tag <String[]>]
       [-Includes <String[]>]
       [-DscResource <String[]>]
       [-RoleCapability <String[]>]
       [-Command <String[]>]
       [-AcceptLicense]
       [-AllowClobber]
       [-SkipPublisherCheck]
       [-InstallUpdate]
       [-NoPathUpdate]
       [<CommonParameters>]

Beschreibung

Das Install-Package Cmdlet installiert mindestens ein Softwarepaket auf dem lokalen Computer. Wenn Sie über mehrere Softwarequellen verfügen, verwenden Get-PackageProvider Sie und Get-PackageSource , um Details zu Ihren Anbietern anzuzeigen.

Wichtig

Die im Modul PackageManagement enthaltenen Befehle unterscheiden sich von den Befehlen, die vom NuGet-Modul in der Paket-Manager-Konsole von Visual Studio bereitgestellt werden. Jedes Modul verfügt über Befehle, die im anderen nicht verfügbar sind. Befehle mit dem gleichen Namen unterscheiden sich in ihren spezifischen Argumenten. Weitere Informationen finden Sie in der PowerShell-Referenzdokumentation für die Paket-Manager-Konsole von Visual Studio.

Beispiele

Beispiel 1: Installieren eines Pakets nach Paketname

Das Install-Package Cmdlet installiert ein Softwarepaket und dessen Abhängigkeiten.

PS> Install-Package -Name NuGet.Core -Source MyNuGet -Credential Contoso\TestUser

Install-Package verwendet Parameter, um den Paketnamen und die Quelle anzugeben. Der Credential-Parameter verwendet ein Domänenbenutzerkonto mit Berechtigungen zum Installieren von Paketen. Der Befehl fordert Sie zur Eingabe des Benutzerkontokennworts auf.

Beispiel 2: Installieren eines Pakets mithilfe von Find-Package

In diesem Beispiel wird das von Find-Package zurückgegebene Objekt über die Pipeline gesendet und von Install-Packageinstalliert.

PS> Find-Package -Name NuGet.Core -Source MyNuGet | Install-Package

Find-Package verwendet die Parameter Name und Source , um nach einem Paket zu suchen. Das -Objekt wird über die Pipeline gesendet und Install-Package installiert das Paket auf dem lokalen Computer.

Beispiel 3: Installieren von Paketen durch Angeben eines Versionsbereichs

Install-Package verwendet die Parameter MinimumVersion und MaximumVersion , um eine Reihe von Softwareversionen anzugeben.

PS> Install-Package -Name NuGet.Core -Source MyNuGet -MinimumVersion 2.8.0 -MaximumVersion 2.9.0

Install-Package verwendet die Parameter Name und Source , um ein Paket zu finden. Die Parameter MinimumVersion und MaximumVersion geben eine Reihe von Softwareversionen an. Die höchste Version im Bereich wird installiert.

Parameter

-AcceptLicense

AcceptLicense akzeptiert die Lizenzvereinbarung während der Installation automatisch.

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

-AllowClobber

Überschreibt Warnmeldungen zu Konflikten mit vorhandenen Befehlen. Überschreibt vorhandene Befehle, die denselben Namen wie die installierten Befehle haben.

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

-AllowPrereleaseVersions

Ermöglicht die Installation von Paketen, die als Vorabversion gekennzeichnet sind.

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

-AllVersions

Install-Package installiert alle verfügbaren Versionen des Pakets. Standardmäßig wird nur die neueste Version installiert.

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

-Command

Gibt einen oder mehrere Befehle an, die Install-Package durchsucht werden.

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

-ConfigFile

Gibt einen Pfad an, der eine Konfigurationsdatei enthält.

Type:String
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

-Contains

Install-Package ruft Objekte ab, wenn der Contains-Parameter einen Wert angibt, der mit einem der Eigenschaftswerte des Objekts übereinstimmt.

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

-Credential

Gibt ein Benutzerkonto an, das über die Berechtigung zum Zugriff auf den Computer und zum Ausführen von Befehlen verfügt. Geben Sie einen Benutzernamen ein, z. B . User01, Domain01\User01, oder geben Sie ein PSCredential-Objekt ein, das Get-Credential vom Cmdlet generiert wird. Wenn Sie einen Benutzernamen eingeben, werden Sie zur Eingabe eines Kennworts aufgefordert.

Wenn der Credential-Parameter nicht angegeben ist, Install-Package wird der aktuelle Benutzer verwendet.

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

-Destination

Gibt einen Pfad zu einem Eingabeobjekt an.

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

-DscResource

Gibt mindestens eine Desired State Configuration -Ressourcen (DSC) an, die von Install-Packagedurchsucht werden. Verwenden Sie das Find-DscResource Cmdlet, um nach DSC-Ressourcen zu suchen.

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

-ExcludeVersion

Wechseln Sie, um die Versionsnummer im Ordnerpfad auszuschließen.

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

-Filter

Gibt Begriffe an, nach den in den Eigenschaften Name und Description gesucht werden sollen.

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

-FilterOnTag

Gibt ein Tag an, das Ergebnisse filtert und Ergebnisse ausschließt, die das angegebene Tag nicht enthalten.

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

-Force

Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer. Überschreibt Einschränkungen, die den Erfolg verhindern Install-Package , mit Ausnahme der Sicherheit.

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

-ForceBootstrap

Erzwingt PackageManagement, den Paketanbieter für das angegebene Paket automatisch zu installieren.

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

-Headers

Gibt die Paketheader an.

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

-Includes

Gibt an, ob Install-Package alle Pakettypen gefunden werden sollen. Die zulässigen Werte für diesen Parameter sind wie folgt:

  • Cmdlet
  • DscResource
  • Funktion
  • RoleCapability
  • Workflow
Type:String[]
Accepted values:Cmdlet, DscResource, Function, RoleCapability, Workflow
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Akzeptiert Pipelineeingaben. Gibt ein Paket mit dem SoftwareIdentity-Typ des Pakets an. Find-Package gibt ein SoftwareIdentity-Objekt aus.

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

-InstallUpdate

Gibt an, dass Install-Package Updates installiert werden.

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

-MaximumVersion

Gibt die maximal zulässige Paketversion an, die Sie installieren möchten. Wenn Sie diesen Parameter nicht angeben, Install-Package installiert die neueste Version des Pakets.

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

-MinimumVersion

Gibt die mindestzugelassene Paketversion an, die Sie installieren möchten. Wenn Sie diesen Parameter nicht hinzufügen, wird die neueste Version des Pakets installiert, Install-Package die alle vom MaximumVersion-Parameter angegebenen Versionen erfüllt.

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

-Name

Gibt mindestens einen Paketnamen an. Mehrere Paketnamen müssen durch Kommas getrennt werden.

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

-NoPathUpdate

NoPathUpdate gilt nur für das Install-Script Cmdlet. NoPathUpdate ist ein dynamischer Parameter, der vom Anbieter hinzugefügt wird und von Install-Packagenicht unterstützt wird.

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

-PackageManagementProvider

Gibt den Namen des PackageManagement-Anbieters an.

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

-ProviderName

Gibt mindestens einen Paketanbieternamen an, auf den Die Paketsuche festgelegt werden soll. Paketanbieternamen können Sie durch Ausführen des Cmdlets Get-PackageProvider abrufen.

Type:String[]
Aliases:Provider
Accepted values:Bootstrap, NuGet, PowerShellGet
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Proxy

Gibt einen Proxyserver für die Anforderung an, anstatt eine direkte Verbindung mit einer 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 zum Verwenden des Proxyservers verfügt, der durch den Proxyparameter angegeben wird.

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

-PublishLocation

Gibt den Pfad zum veröffentlichten Speicherort eines Pakets an.

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

-RequiredVersion

Gibt die genaue zulässige Version des Pakets an, das Sie installieren möchten. Wenn Sie diesen Parameter nicht hinzufügen, wird die neueste Version des Pakets installiert, Install-Package die alle vom MaximumVersion-Parameter angegebenen Versionen erfüllt.

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

-RoleCapability

Gibt ein Array von Rollenfunktionen an.

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

-Scope

Gibt den Bereich an, für den das Paket installiert werden soll. Die zulässigen Werte für diesen Parameter sind wie folgt:

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

-ScriptPublishLocation

Gibt den Pfad zum veröffentlichten Speicherort eines Skripts an.

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

-ScriptSourceLocation

Gibt den Quellspeicherort des Skripts an.

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

-SkipDependencies

Überspringt die Installation von Softwareabhängigkeiten.

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

-SkipPublisherCheck

Ermöglicht es Ihnen, eine Paketversion zu erhalten, die neuer als Ihre installierte Version ist. Beispielsweise ein installiertes Paket, das von einem vertrauenswürdigen Herausgeber digital signiert ist, aber eine neue Version nicht digital signiert ist.

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

-SkipValidate

Schalter, bei dem die Überprüfung der Anmeldeinformationen eines Pakets übersprungen wird.

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

-Source

Gibt mindestens eine Paketquelle an. Mehrere Paketquellnamen müssen durch Kommas getrennt werden. Sie können Paketquellnamen abrufen, indem Sie das Get-PackageSource Cmdlet ausführen.

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

-Tag

Gibt eine oder mehrere Zeichenfolgen an, nach der in den Paketmetadaten gesucht werden soll.

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

-Type

Gibt an, ob nach Paketen mit einem Modul, einem Skript oder beidem gesucht werden soll. Die zulässigen Werte für diesen Parameter sind wie folgt:

  • Modul
  • Skript
  • Alle
Type:String
Accepted values:Module, Script, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zeigt an, was passieren würde, wenn Install-Package 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 weiterleiten.

Ausgaben

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Dieses Cmdlet gibt ein SoftwareIdentity-Objekt für jedes Paket zurück, das es installiert.

Hinweise

Das Einschließen eines Paketanbieters in einen Befehl kann dynamische Parameter für ein Cmdlet verfügbar machen. Dynamische Parameter sind spezifisch für einen Paketanbieter. Das Get-Help Cmdlet listet die Parametersätze eines Cmdlets auf und enthält den Parametersatz des Anbieters. Beispielsweise ist der PowerShellGet-Parameter festgelegt, Install-Package der , AllowClobberund SkipPublisherCheckenthält-NoPathUpdate.

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.