winget ツールを使用したアプリケーションのインストールと管理

  • [アーティクル]

winget コマンド ライン ツールを使用すると、Windows 10 および Windows 11 コンピューター上でアプリケーションを検出、インストール、アップグレード、削除、および構成することができます。 このツールは、Windows パッケージ マネージャー サービスに対するクライアント インターフェイスです。

winget をインストールする

Windows パッケージ マネージャーの winget コマンドライン ツールは、アプリ インストーラーの一部として Windows 11 と最新バージョンの Windows 10 で利用できます。

アプリ インストーラーは Microsoft Store から取得できます。 既にインストールされている場合は、最新バージョンに更新されていることを確認してください。

Note

winget コマンド ライン ツールは、現時点では Windows 10 1709 (ビルド 16299) 以降でのみサポートされています。 winget ツールは、ユーザーとして Windows に初めてログインし、Microsoft Store をトリガーして非同期プロセスの一部として Windows パッケージ マネージャーを登録するまで使用できるようになりません。 最近ユーザーとして初めてログインし、winget がまだ使用できないことがわかった場合、PowerShell を開き、次のコマンドを入力して、この winget 登録を要求できます: Add-AppxPackage -RegisterByFamilyName -MainPackage Microsoft.DesktopAppInstaller_8wekyb3d8bbwe。

winget プレビュー バージョンをインストールする [開発者のみ]

WinGet は Windows アプリ インストーラーに含まれています。 最新の Windows パッケージ マネージャーの機能を試すために、次のいずれかの方法プレビュー ビルドをインストールできます。

  • 最新の winget プレビュー バージョンをダウンロードします。 新機能については、winget プレビューのリリース ノートを参照してください。 このパッケージをインストールすると、WinGet クライアントのプレビュー バージョンが提供されますが、Microsoft Store からの新しいプレビュー バージョンの自動更新は有効になりません。

  • Microsoft アカウント (MSA)、職場、学校、または Azure Active Directory (AAD) アカウントを使用して、Windows Insider Dev チャネルに新規登録します。 Windows Insider Dev チャネルには、Microsoft Store からの新しいプレビュー バージョンの自動更新が含まれています。

  • Microsoft アカウント (MSA) を使用して、Windows パッケージ マネージャーの Insiders Program に新規登録します。 Microsoft アカウント (MSA) が追加されると、(電子メール通知を受信してから数日後に) Microsoft Store から新しいプレビュー バージョンの自動更新を受け取ります。

Windows サンドボックスに winget をインストールする

Windows サンドボックスは、アプリケーションを分離して安全に実行するための軽量デスクトップ環境を提供します。 Windows サンドボックス環境内にインストールされたソフトウェアは "サンドボックス化" されたままであり、ホスト コンピューターとは別に実行されます。 Windows サンドボックスには winget も Microsoft Store アプリも含まれていないため、GitHub の winget リリース ページから最新の winget パッケージをダウンロードする必要があります。

Windows サンドボックスに winget の安定リリースをインストールするには、Windows PowerShell コマンド プロンプトで次の手順に従います。

$progressPreference = 'silentlyContinue'
Write-Information "Downloading WinGet and its dependencies..."
Invoke-WebRequest -Uri https://aka.ms/getwinget -OutFile Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.msixbundle
Invoke-WebRequest -Uri https://aka.ms/Microsoft.VCLibs.x64.14.00.Desktop.appx -OutFile Microsoft.VCLibs.x64.14.00.Desktop.appx
Invoke-WebRequest -Uri https://github.com/microsoft/microsoft-ui-xaml/releases/download/v2.8.6/Microsoft.UI.Xaml.2.8.x64.appx -OutFile Microsoft.UI.Xaml.2.8.x64.appx
Add-AppxPackage Microsoft.VCLibs.x64.14.00.Desktop.appx
Add-AppxPackage Microsoft.UI.Xaml.2.8.x64.appx
Add-AppxPackage Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.msixbundle

パッケージ マネージャーのプレビューまたは別のバージョンが必要な場合は、https://github.com/microsoft/winget-cli/releases に移動します。 必要なバージョンの URL をコピーし、上記の URI を更新します。

サンドボックスのインストール方法や、その使用で何ができるかなどの Windows サンドボックスの詳細については、Windows サンドボックスドキュメントを参照してください。

管理者に関する考慮事項

インストーラーの動作は、管理者特権で winget を実行しているかどうかによって異なる場合があります。

  • 管理者特権を使用せずに winget を実行している場合、アプリケーションによっては、インストールするために昇格が必要になる可能性があります。 インストーラーが実行されると、Windows は、昇格を求めるメッセージを表示します。 昇格しないことを選択すると、アプリケーションのインストールは失敗します。

  • 管理者コマンド プロンプトで winget を実行しているときは、アプリケーションで必要とする場合に昇格のプロンプトは表示されません。 管理者としてコマンド プロンプトを実行しているときは常に注意し、信頼できるアプリケーションのみをインストールしてください。

winget を使用する

アプリ インストーラーをインストールした後、コマンド プロンプトから "winget" と入力して winget を実行できます。

最も一般的な使用シナリオの 1 つは、お気に入りのツールを検索してインストールすることです。

  1. ツールを検索するには、winget search <appname> と入力します。

  2. 目的のツールが使用可能であることを確認したら、winget install <appname> と入力してツールをインストールできます。 winget ツールがインストーラーを起動し、お使いの PC にアプリケーションをインストールします。 winget commandline

  3. install と search に加えて、winget には、アプリケーションの詳細の表示、ソースの変更、およびパッケージの検証を可能にする、他のいくつかのコマンドが用意されています。 コマンドの全一覧を表示するには、winget --help と入力します。 winget help

一部のユーザーにより、クライアントが PATH に存在しない問題が報告されています。

コマンド

winget ツールの現在のプレビューでは、次のコマンドがサポートされています。

コマンド 説明
info システムに関するメタデータ (バージョン番号、アーキテクチャ、ログの場所など) を表示します。 トラブルシューティングに役立つリソース
install 指定されたアプリケーションをインストールします。
show 指定されたアプリケーションの詳細を表示します。
source winget ツールによってアクセスされる Windows パッケージ マネージャーのリポジトリを追加、削除、および更新します。
search アプリケーションを検索します。
list インストール済みパッケージを表示します。
upgrade 指定したパッケージをアップグレードします。
uninstall 指定したパッケージをアンインストールします。
hash インストーラーの SHA256 ハッシュを生成します。
validate Windows パッケージ マネージャー リポジトリに送信するマニフェスト ファイルを検証します。
設定 設定を開きます。
features 試験的な機能の状態を示します。
export インストール済みパッケージの一覧をエクスポートします。
import ファイル内のすべてのパッケージをインストールします。
pin パッケージ ピンを管理します。
configure システムを目的の状態に構成します。
download 指定したアプリケーションのインストーラーをダウンロードします。

[オプション]

winget ツールでは、次のオプションがサポートされています。

オプション 説明
-v、--version winget の現在のバージョンを返します。
--info ライセンス、プライバシーに関する声明、構成済みのグループ ポリシーへのリンクを含む、winget に関するすべての詳細情報を提供します。
-?、--help winget の追加のヘルプを表示します。

サポートされているインストーラー形式

winget ツールでは、次の種類のインストーラーがサポートされています。

  • EXE (Silent および SilentWithProgress フラグあり)
  • 郵便番号
  • INNO
  • NULLSOFT
  • MSI
  • WIX
  • APPX
  • MSIX
  • BURN
  • PORTABLE

スクリプト作成 winget

次の構文を使用すると、1 つのコマンドで複数のアプリケーションをインストールできます。

USAGE: winget install <query1> <query2> ...

例

winget install Microsoft.WindowsTerminal Microsoft.PowerToys Microsoft.VisualStudioCode

Note

スクリプト化されると、winget は、指定された順序でアプリケーションを起動します。 インストーラーが成功または失敗を返すと、winget は次のインストーラーを起動します。 インストーラーが別のプロセスを起動すると、途中で winget に返される可能性があります。 これにより、前のインストーラーが完了する前に、winget は次のインストーラーをインストールします。

デバッグおよびトラブルシューティング

winget には、問題の診断に役立つログ記録が用意されています。 トラブルシューティングとログ記録の詳細については、デバッグとトラブルシューティングに関する記事を参照してください。

欠落しているツール

コミュニティ リポジトリにツールまたはアプリケーションが含まれていない場合は、リポジトリにパッケージを送信してください。 お気に入りのツールを追加することで、自分や他のすべてのユーザーが使用できるようになります。

winget 設定のカスタマイズ

winget コマンド ラインのエクスペリエンスを構成するには、settings.json ファイルを変更します。 詳細については、「https://aka.ms/winget-settings」を参照してください。 設定はまだ試験的な状態であり、ツールのプレビュー バージョン向けにまだ最終化されていないことに注意してください。

オープン ソースの詳細

winget ツールは、GitHub のリポジトリ https://github.com/microsoft/winget-cli/ から入手できるオープン ソース ソフトウェアです。 クライアントを構築するためのソースは、src フォルダーにあります。

winget のソースは、Visual Studio 2019 C++ ソリューションに含まれています。 ソリューションを正しく構築するには、最新の Visual Studio と C++ ワークロードをインストールしてください。

GitHub の winget ソースに投稿することをお勧めします。 まず、Microsoft CLA に同意して署名する必要があります。

トラブルシューティング

winget-cli リポジトリでは、一般的な問題やエラーの一覧と共に、問題の解決方法についての提案が保持されています。