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-Package
PackageManagement 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-Package
diesem 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, -NoPathUpdate
Get-Package
der , , AllowClobber
und 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.