upgrade コマンド (winget)
winget ツールの upgrade コマンドを使用すると、指定したアプリケーションがアップグレードされます。 必要に応じて、list コマンドを使用して、アップグレードする必要のあるアプリケーションを特定することもできます。
upgrade コマンドでアップグレードするには、正確な文字列を指定する必要があります。 あいまいさがある場合は、upgrade コマンドを正確なアプリケーションに絞り込むように求めるプロンプトが表示されます。
Aliases
このコマンドでは、次のエイリアスを使用できます。
- update
使用方法
winget upgrade [[-q] <query> ...] [<options>]
引数
次の引数を使用できます。
| 引数 | 説明 |
|---|---|
| -q、--query | アプリを検索するために使用するクエリ。 |
注意
query 引数は位置指定です。 ワイルドカード スタイルの構文はサポートされていません。 多くの場合、これはアップグレードするパッケージを見つけるために使う文字列です。
Options
オプションを使用すると、upgrade のエクスペリエンスをニーズに合わせてカスタマイズできます。
| オプション | 説明 |
|---|---|
| -m、--manifest | この後にマニフェスト (YAML) ファイルのパスを指定する必要があります。 マニフェストを使用して、ローカル YAML ファイルから upgrade のエクスペリエンスを実行できます。 |
| --id | アップグレードをアプリケーションの ID に限定します。 |
| --name | 検索をアプリケーションの名前に限定します。 |
| --moniker | 検索をアプリケーション用に一覧表示されているモニカーに限定します。 |
| -v、--version | アップグレードする正確なバージョンを指定できます。 指定しない場合、最新のバージョンによって最も高いバージョンのアプリケーションにアップグレードされます。 |
| -s、--source | 検索を、指定されたソース名に制限します。 この後にソース名を指定する必要があります。 |
| -e、--exact | 大文字小文字の区別の検査を含め、クエリで正確な文字列を使用します。 部分文字列の既定の動作は使用されません。 |
| -i、--interactive | 対話型モードでインストーラーを実行します。 既定のエクスペリエンスでは、インストーラーの進行状況が表示されます。 |
| -h、--silent | サイレント モードでインストーラーを実行します。 これにより、すべての UI が抑制されます。 既定のエクスペリエンスでは、インストーラーの進行状況が表示されます。 |
| --purge | パッケージ ディレクトリ内のすべてのファイルとディレクトリを削除します (移植可能) |
| -o、--log | ログ記録をログ ファイルに送信します。 書き込み権限を持っているファイルへのパスを指定する必要があります。 |
| --custom | 既定値に加えてインストーラーに渡される引数。 |
| --override | インストーラーに直接渡される文字列。 |
| -l、--location | アップグレードする場所 (サポートされている場合)。 |
| --scope | インストールされているパッケージ スコープ フィルター (ユーザーまたはマシン) を選択します。 |
| a, --architecture | インストールするアーキテクチャを選択します。 |
| --installer-type | アップグレードするインストーラーの種類を選択します。 WinGet クライアントでサポートされているインストーラーの種類に関する記述を参照してください。 |
| --locale | 使用するロケール (BCP47 形式) を指定します。 |
| --ignore-security-hash | インストーラーのハッシュ チェック エラーを無視します。 非推奨。 |
| --allow-reboot | 必要に応じて再起動を許可します。 |
| --skip-dependencies | パッケージの依存関係と Windows 機能の処理をスキップします。 |
| --ignore-local-archive-malware-scan | ローカル マニフェストからアーカイブの種類のパッケージをインストールする際に実行されるマルウェア スキャンは無視します。 |
| --accept-package-agreements | 使用許諾契約に同意し、プロンプトを回避するために使用されます。 |
| --accept-source-agreements | ソースの使用許諾契約に同意し、プロンプトを回避するために使用されます。 |
| --header | 省略可能な Windows-Package-Manager REST ソースの HTTP ヘッダー。 |
| --authentication-mode | 認証ウィンドウの基本設定 (silent、silentPreferred、interactive のいずれか) を指定します。 |
| --authentication-account | 認証に使用するアカウントを指定します。 |
| -r, --recurse, --all | インストールされているすべてのパッケージを最新バージョン (使用可能な場合) にアップグレードします。 |
| -u, --unknown, --include-unknown | 現在のバージョンを特定できない場合でも、パッケージをアップグレードします。 |
| --pinned,--include-pinned | ブロックされていないピンがある場合でも、パッケージをアップグレードします。 |
| --uninstall-previous | アップグレード中に以前のバージョンのパッケージをアンインストールします。 動作は、個々のパッケージによって異なります。 一部のインストーラーは、新しいバージョンを並列でインストールするように設計されています。 一部のインストーラーには "uninstallPrevious" を指定するマニフェストが含まれているため、このコマンド フラグを使用しなくても古いバージョンがアンインストールされます。 この場合、winget upgrade --uninstall-previous コマンドを使用すると、パッケージ マニフェストの内容に関係なく、古いバージョンをアンインストールするように WinGet に指示されます。 パッケージ マニフェストに "uninstallPrevious" が含まれていなくて、--uninstall-previous フラグが使用されていない場合は、インストーラーの既定の動作が適用されます。 |
| --force | コマンドを直接実行し、セキュリティ関連以外の問題を続行します。 |
| -?,--help | 選択したコマンドに関するヘルプを表示します。 |
| --wait | 終了する前に任意のキーを押すようユーザーに求めます。 |
| --logs,--open-logs | 既定のログの場所を開きます。 |
| --verbose, --verbose-logs | ログ記録設定をオーバーライドし、詳細ログを作成します。 |
| --nowarn、--ignore-warnings | 警告の出力を抑制します。 |
| --disable-interactivity | 対話型プロンプトを無効にします。 |
| --proxy | この実行に使用するプロキシを設定します。 |
| --no-proxy | この実行に対してプロキシの使用を無効にします。 |
クエリの例
次の例では、アプリケーションの特定のバージョンにアップグレードします。
winget upgrade powertoys --version 0.15.2
次の例では、アプリケーションをその ID からアップグレードします。
winget upgrade --id Microsoft.PowerToys
すべてのアプリをアップグレードする例を次に示します。
winget upgrade --all
upgrade の使用
更新が必要なアプリを特定するには、引数なしで upgrade を使用するだけで、使用可能なすべてのアップグレードが表示されます。
下の例では、winget upgrade により、利用可能な更新プログラムがあるアプリがユーザーに表示されます。 利用可能な更新プログラムから、ユーザーは JanDeDobbeleer.OhMyPosh で更新プログラムが利用可能であることを識別し、upgrade を使用してアプリケーションを更新します。
list と upgrade の使用
特定のアプリで使用可能な更新プログラムを検索するには、list コマンドを使用します。 特定のアプリで更新プログラムが利用可能であることを確認したら、upgrade を使用して最新のものをインストールします。
下の例では、list コマンドを使用して、Microsoft.WindowsTerminalPreview の更新プログラムが利用可能であることを確認しています。 その後、ユーザーは upgrade を使用してアプリケーションを更新します。
upgrade --all
upgrade --all は、アップグレードが利用可能なすべてのアプリケーションを示します。 winget upgrade --all を実行すると、Windows パッケージ マネージャーによって更新プログラムが利用可能なすべてのアプリケーションが検索されて、更新プログラムのインストールが試みられます。
注意
一部のアプリケーションでは、バージョンが提供されません。 常に最新のものです。 Windows パッケージ マネージャーでアプリの新しいバージョンがあるかどうかを識別できないため、アップグレードすることはできません。
upgrade --uninstall-previous
upgrade --uninstall-previous は、パッケージの新しいバージョンをインストールする前に、以前のバージョンをアンインストールします。 --uninstall-previous 使用時、動作は個々のパッケージによって異なります。 一部のインストーラーは、新しいバージョンをサイド バイ サイドでインストールするように設計されていますが、他のインストーラーには既定のアップグレード動作として uninstallPrevious を指定するマニフェストが含まれています (そのため、コマンド フラグを使用しなくても以前のバージョンがアンインストールされます)。
パッケージ マニフェストにアップグレード動作として uninstallPrevious が含まれておらず、--uninstall-previous フラグが upgrade コマンドで使用されていない場合、インストーラーの既定の動作が適用されます。
Windows developer