Freigeben ü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, die mit PackageManagement installiert wurden. 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 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: 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

Mit diesem Befehl wird eine Liste der Pakete abgerufen, 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 ComputerName-Parameter , um einen Remotecomputer server01 anzugeben. Der Credential-Parameter gibt einen Domänen- und 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

Mit diesem Befehl werden Softwarepakete abgerufen, die von einem bestimmten Anbieter auf dem lokalen Computer installiert sind.

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 anzugeben, PowerShellGet. Der AllVersions-Parameter zeigt jede installierte Version an.

Beispiel 4: Abrufen einer genauen Version eines bestimmten Pakets

Mit diesem Befehl wird eine bestimmte Version eines installierten Pakets abgerufen. Es kann mehr als eine Version eines Pakets 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 Name-Parameter , um den Paketnamen PackageManagement anzugeben. Der ProviderName-Parameter 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 dann 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 in der Pipeline an das Uninstall-Package Cmdlet gesendet. Uninstall-Package entfernt das Paket.

Parameter

-AllowClobber

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

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

-AllowPrereleaseVersions

Enthält Pakete, die als Vorabrelease in den Ergebnissen markiert sind.

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

-AllVersions

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

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

-Destination

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

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

-Force

Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.

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

-ForceBootstrap

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

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

-InstallUpdate

Gibt an, dass dieses Cmdlet Updates installiert.

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

-MaximumVersion

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

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

-MinimumVersion

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

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

-Name

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

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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-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 eines Paketverwaltungsanbieters an.

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

-ProviderName

Gibt mindestens einen Paketanbieternamen an. Trennen Sie mehrere Paketanbieternamen durch Kommas. Verwenden Sie Get-PackageProvider , um eine Liste der verfügbaren Paketanbieter abzurufen.

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

-RequiredVersion

Gibt die genaue Version des zu findenden Pakets an.

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

-Scope

Gibt den Suchbereich für das Paket an.

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

-SkipDependencies

Switch, der angibt, dass die Suche nach Paketabhängigkeiten übersprungen wird.

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

-Type

Gibt an, ob nach Paketen mit einem Modul, einem Skript oder einem der beiden suchen werden soll.

Type:String
Accepted values:Module, Script, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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. Beispielsweise ist der PowerShellGet-Parameter festgelegt, Get-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.