Teilen über


Get-Package

Gibt eine Liste aller Softwarepakete zurück, die mit PackageManagement installiert wurden.

Syntax

Get-Package
   [[-Name] <String[]>]
   [-RequiredVersion <String>]
   [-MinimumVersion <String>]
   [-MaximumVersion <String>]
   [-AllVersions]
   [-Force]
   [-ForceBootstrap]
   [-ProviderName <String[]>]
   [-Destination <String>]
   [-ExcludeVersion]
   [-Scope <String>]
   [-SkipDependencies]
   [<CommonParameters>]
Get-Package
   [[-Name] <String[]>]
   [-RequiredVersion <String>]
   [-MinimumVersion <String>]
   [-MaximumVersion <String>]
   [-AllVersions]
   [-Force]
   [-ForceBootstrap]
   [-ProviderName <String[]>]
   [-Scope <String>]
   [-PackageManagementProvider <String>]
   [-Type <String>]
   [-AllowClobber]
   [-SkipPublisherCheck]
   [-InstallUpdate]
   [-NoPathUpdate]
   [-AllowPrereleaseVersions]
   [<CommonParameters>]

Beschreibung

Das Get-Package Cmdlet gibt eine Liste aller Softwarepakete auf dem lokalen Computer zurück, der mit PackageManagement installiert wurde. Sie können auf Remotecomputern ausführen Get-Package , indem Sie sie als Teil eines Invoke-Command Befehls oder Enter-PSSession Skripts ausführen.

Wichtig

Die im PackageManagement-Modul 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 in der anderen Nicht verfügbar sind. Befehle mit demselben 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: Abrufen aller installierten Pakete

Das Get-Package Cmdlet ruft alle Pakete ab, die auf dem lokalen Computer installiert sind.

Get-Package

Name           Version      Source                                     ProviderName
----           -------      ------                                     ------------
posh-git       0.7.3        https://www.powershellgallery.com/api/v2   PowerShellGet

Beispiel 2: Abrufen von Paketen, die auf einem Remotecomputer installiert sind

Dieser Befehl ruft eine Liste der Pakete ab, die von PackageManagement auf einem Remotecomputer installiert wurden. Mit diesem Befehl werden Sie aufgefordert, das Kennwort des angegebenen Benutzers anzugeben.

PS> Invoke-Command -ComputerName Server01 -Credential CONTOSO\TestUser -ScriptBlock {Get-Package}

Invoke-Command verwendet den Parameter ComputerName , um einen Remotecomputer anzugeben, Server01. Der Parameter "Credential " gibt eine Domäne und einen Benutzernamen mit Berechtigungen zum Ausführen von Befehlen auf dem Computer an. Der ScriptBlock-Parameter führt das Get-Package Cmdlet auf dem Remotecomputer aus.

Beispiel 3: Abrufen von Paketen für einen angegebenen Anbieter

Dieser Befehl ruft Softwarepakete auf dem lokalen Computer von einem bestimmten Anbieter ab.

Get-Package -ProviderName PowerShellGet -AllVersions

Name                  Version      Source                                     ProviderName
----                  -------      ------                                     ------------
PackageManagement     1.2.2        https://www.powershellgallery.com/api/v2   PowerShellGet
PackageManagement     1.3.1        https://www.powershellgallery.com/api/v2   PowerShellGet
posh-git              0.7.3        https://www.powershellgallery.com/api/v2   PowerShellGet
PowerShellGet         2.0.1        https://www.powershellgallery.com/api/v2   PowerShellGet

Get-Package verwendet den ProviderName-Parameter , um einen bestimmten Anbieter, PowerShellGet, anzugeben. Der Parameter "AllVersions" zeigt jede installierte Version an.

Beispiel 4: Abrufen einer genauen Version eines bestimmten Pakets

Dieser Befehl ruft eine bestimmte Version eines installierten Pakets ab. Mehrere Versionen eines Pakets können installiert werden.

Get-Package -Name PackageManagement -ProviderName PowerShellGet -RequiredVersion 1.3.1

Name                  Version      Source                                     ProviderName
----                  -------      ------                                     ------------
PackageManagement     1.3.1        https://www.powershellgallery.com/api/v2   PowerShellGet

Get-Package verwendet den Parameter "Name ", um den Paketnamen " PackageManagement" anzugeben. Der Parameter ProviderName gibt den Anbieter PowerShellGet an. Der Parameter RequiredVersion gibt eine installierte Version an.

Beispiel 5: Deinstallieren eines Pakets

In diesem Beispiel werden Paketinformationen abgerufen und anschließend das Paket deinstalliert.

Get-Package -Name posh-git -RequiredVersion 0.7.3 | Uninstall-Package

Get-Package verwendet den Parameter "Name ", um den Paketnamen ,posh-git" anzugeben. Der Parameter RequiredVersion ist eine bestimmte Version des Pakets. Das Objekt wird an das Cmdlet Uninstall-Package weitergeleitet. Uninstall-Package entfernt das Paket.

Parameter

-AllowClobber

Überschreibt Warnmeldungen zu Konflikten mit vorhandenen Befehlen. Überschreibt vorhandene Befehle mit demselben Namen wie Befehle, die von einem Modul installiert werden.

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

-AllowPrereleaseVersions

Enthält Pakete, die in den Ergebnissen als Vorabversion gekennzeichnet sind.

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

-AllVersions

Gibt an, dass Get-Package alle verfügbaren Versionen des Pakets zurückgegeben werden. Gibt standardmäßig Get-Package nur die neueste verfügbare Version zurück.

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

-Destination

Gibt den Pfad zu einem Verzeichnis an, das extrahierte Paketdateien enthält.

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

-ExcludeVersion

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

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

-Force

Erzwingt die Ausführung des Befehls, ohne eine Benutzerbestätigung zu verlangen.

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

-ForceBootstrap

Gibt an, dass Get-PackagePackageManagement gezwungen wird, den Paketanbieter automatisch zu installieren.

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

-InstallUpdate

Gibt an, dass dieses Cmdlet Updates installiert.

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

-MaximumVersion

Gibt die maximale Paketversion an, die Sie suchen möchten.

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

-MinimumVersion

Gibt die Mindestpaketversion an, die Sie suchen möchten. Wenn eine höhere Version verfügbar ist, wird diese Version zurückgegeben.

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

-Name

Gibt einen oder mehrere Paketnamen oder Paketnamen mit Wildcardzeichen an. Trennen Sie mehrere Paketnamen durch Kommas.

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

-NoPathUpdate

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

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

-PackageManagementProvider

Gibt den Namen eines Paketverwaltungsanbieters an.

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

-ProviderName

Gibt einen oder mehrere Paketanbieternamen an. Trennen Sie mehrere Paketanbieternamen durch Kommas. Dient Get-PackageProvider zum Abrufen einer Liste der verfügbaren Paketanbieter.

Typ:String[]
Aliase:Provider
Zulässige Werte:Bootstrap, NuGet, PowerShellGet
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-RequiredVersion

Gibt die genaue Version des zu findenden Pakets an.

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

-Scope

Gibt den Suchbereich für das Paket an.

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

-SkipDependencies

Switch, der angibt, die Suche nach Paketabhängigkeiten zu überspringen.

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

-SkipPublisherCheck

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

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

-Type

Gibt an, ob nach Paketen mit einem Modul, einem Skript oder einem anderen gesucht werden soll.

Typ:String
Zulässige Werte:Module, Script, All
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Ausgaben

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Dieses Cmdlet gibt ein SoftwareIdentity-Objekt für jedes installierte Paket zurück, das den Parametern entspricht. Standardmäßig wird jedes installierte Paket zurückgegeben.

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. Verfügt beispielsweise über den PowerShellGet-Parametersatz, -NoPathUpdateGet-Package der , , AllowClobberund SkipPublisherCheck.

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.