Get-Package
PackageManagement と共にインストールされたすべてのソフトウェア パッケージの一覧を返します。
構文
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>]
説明
Get-Package
コマンドレットは、PackageManagement と共にインストールされたローカル コンピューター上のすべてのソフトウェア パッケージの一覧を返します。 リモート コンピューターで Get-Package
を実行するには、 Invoke-Command
または Enter-PSSession
コマンドまたはスクリプトの一部として実行します。
重要
PackageManagement モジュールに含まれるコマンドは、Visual Studio のパッケージ マネージャー コンソールの NuGet モジュールによって提供されるコマンドとは異なります。 各モジュールには、他のモジュールでは使用できないコマンドがあります。 同じ名前のコマンドは、特定の引数で異なります。 詳細については、Visual Studio のパッケージ マネージャー コンソールの PowerShell リファレンス ドキュメントを参照してください。
例
例 1: インストールされているすべてのパッケージを取得する
Get-Package
コマンドレットは、ローカル コンピューターにインストールされているすべてのパッケージを取得します。
Get-Package
Name Version Source ProviderName
---- ------- ------ ------------
posh-git 0.7.3 https://www.powershellgallery.com/api/v2 PowerShellGet
例 2: リモート コンピューターにインストールされているパッケージを取得する
このコマンドは、リモート コンピューターに PackageManagement によってインストールされたパッケージの一覧を取得します。 このコマンドを実行すると、指定したユーザーのパスワードを指定するように求められます。
PS> Invoke-Command -ComputerName Server01 -Credential CONTOSO\TestUser -ScriptBlock {Get-Package}
Invoke-Command
は ComputerName パラメーターを使用してリモート コンピューター Server01 を指定します。
Credential パラメーターは、コンピューターでコマンドを実行するためのアクセス許可を持つドメインとユーザー名を指定します。
ScriptBlock パラメーターは、リモート コンピューターで Get-Package
コマンドレットを実行します。
例 3: 指定したプロバイダーのパッケージを取得する
このコマンドは、特定のプロバイダーからローカル コンピューターにインストールされているソフトウェア パッケージを取得します。
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
では、 ProviderName パラメーターを使用して、特定のプロバイダー である PowerShellGet を指定します。
AllVersions パラメーターには、インストールされている各バージョンが表示されます。
例 4: 特定のパッケージの正確なバージョンを取得する
このコマンドは、インストールされているパッケージの特定のバージョンを取得します。 複数のバージョンのパッケージをインストールできます。
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
では 、Name パラメーターを使用してパッケージ名 PackageManagement を指定します。
ProviderName パラメーターは、プロバイダーである PowerShellGet を指定します。
RequiredVersion パラメーターは、インストールされているバージョンを指定します。
例 5: パッケージをアンインストールする
この例では、パッケージ情報を取得し、パッケージをアンインストールします。
Get-Package -Name posh-git -RequiredVersion 0.7.3 | Uninstall-Package
Get-Package
では、 Name パラメーターを使用してパッケージ名 posh-git を指定します。
RequiredVersion パラメーターは、パッケージの特定のバージョンです。 オブジェクトは、パイプラインから Uninstall-Package
コマンドレットに送信されます。
Uninstall-Package
はパッケージを削除します。
パラメーター
-AllowClobber
既存のコマンドとの競合に関する警告メッセージをオーバーライドします。 モジュールによってインストールされているコマンドと同じ名前の既存のコマンドを上書きします。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AllowPrereleaseVersions
結果にプレリリースとしてマークされたパッケージが含まれます。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AllVersions
Get-Package
が使用可能なすべてのバージョンのパッケージを返すように指定します。 既定では、 Get-Package
は使用可能な最新バージョンのみを返します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Destination
抽出されたパッケージ ファイルを含むディレクトリへのパスを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ExcludeVersion
フォルダー パスのバージョン番号を除外するように切り替えます。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Force
ユーザーの確認を求めずにコマンドを強制的に実行します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ForceBootstrap
Get-Package
によって PackageManagement にパッケージ プロバイダーが自動的にインストールされることを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InstallUpdate
このコマンドレットが更新プログラムをインストールすることを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-MaximumVersion
検索するパッケージの最大バージョンを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-MinimumVersion
検索するパッケージの最小バージョンを指定します。 上位のバージョンが使用可能な場合は、そのバージョンが返されます。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Name
1 つ以上のパッケージ名、またはワイルドカード文字を含むパッケージ名を指定します。 複数のパッケージ名をコンマで区切ります。
型: | String[] |
配置: | 0 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | True |
-NoPathUpdate
NoPathUpdate は 、 Install-Script
コマンドレットにのみ適用されます。
NoPathUpdate はプロバイダーによって追加される動的パラメーターであり、 Get-Package
ではサポートされていません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PackageManagementProvider
パッケージ管理プロバイダーの名前を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ProviderName
1 つ以上のパッケージ プロバイダー名を指定します。 複数のパッケージ プロバイダー名をコンマで区切ります。
Get-PackageProvider
を使用して、使用可能なパッケージ プロバイダーの一覧を取得します。
型: | String[] |
Aliases: | Provider |
指定可能な値: | Bootstrap, NuGet, PowerShellGet |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-RequiredVersion
検索するパッケージの正確なバージョンを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Scope
パッケージの検索範囲を指定します。
型: | String |
指定可能な値: | CurrentUser, AllUsers |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SkipDependencies
パッケージの依存関係の検索をスキップするように指定するスイッチ。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SkipPublisherCheck
インストールされているバージョンよりも新しいパッケージ バージョンを取得できます。 たとえば、信頼できる発行元によってデジタル署名されているが、新しいバージョンがデジタル署名されていないインストール済みパッケージなどです。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Type
モジュール、スクリプト、またはいずれかのパッケージを検索するかどうかを指定します。
型: | String |
指定可能な値: | Module, Script, All |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
出力
Microsoft.PackageManagement.Packaging.SoftwareIdentity
このコマンドレットは、パラメーターに一致するインストール済みパッケージごとに SoftwareIdentity オブジェクトを返します。 既定では、インストールされているすべてのパッケージが返されます。
メモ
コマンドにパッケージ プロバイダーを含めると、コマンドレットで動的パラメーターを使用できるようになります。 動的パラメーターは、パッケージ プロバイダーに固有です。
Get-Help
コマンドレットは、コマンドレットのパラメーター セットを一覧表示し、プロバイダーのパラメーター セットを含みます。 たとえば、Get-Package
には、-NoPathUpdate
、AllowClobber
、およびSkipPublisherCheck
を含む PowerShellGet パラメーター セットがあります。
重要
2020 年 4 月の時点で、PowerShell ギャラリーはトランスポート層セキュリティ (TLS) バージョン 1.0 と 1.1 をサポートしなくなりました。 TLS 1.2 以降を使用していない場合は、PowerShell ギャラリーにアクセスしようとするとエラーが表示されます。 TLS 1.2 を使用していることを確認するには、次のコマンドを使用します。
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
詳細については、PowerShell ブログの のお知らせ を参照してください。