結論
winget(WinGet)は、Microsoft が提供する Windows のパッケージ管理のコマンドです。アプリの検索・インストール・更新・削除を、ターミナルに1行打つだけで行えます。入っているアプリをまとめて更新するなら winget upgrade で一覧を見てから winget upgrade --all。Windows 11 と Windows 10(1809 以降)のどちらでも、使い方は同じです。
この記事でわかること
- winget のコマンド一覧(全18サブコマンド)と、ID・
--exactで1つに絞る方法 - 一括更新・export/import の JSON・マニフェスト(YAML)の形を公式スキーマで検証した結果
- 「認識されていません」などのつまずき、エラーコード203件の読み方、Chocolatey・Scoop との違い
winget は、アプリの「置き場所(ソース)」から情報を受け取り、そのアプリ本来のインストーラーを代わりに動かします。ブラウザで配布ページを探して、ダウンロードして、ダブルクリックする、という手順をコマンド1行に置き換える道具です。
flowchart TD
U[winget install コマンド] --> S[ソースを検索<br>winget・msstore]
S --> M[マニフェスト<br>URL・ハッシュ]
M --> D[インストーラーを取得]
D --> H{ハッシュが一致?}
H -->|はい| I[インストーラーを実行]
H -->|いいえ| X[止まる]
よく調べられることの答えを先にまとめます。
| やりたいこと | いちばん早い方法 | 詳しい節 |
|---|---|---|
| winget とは何か知りたい | Windows 標準のパッケージ管理。アプリ インストーラーの一部 | wingetとは |
| winget が使えるか確かめる | winget --version |
使えるか確かめる・入れ方 |
| アプリを探して入れる | winget search 名前 → winget install --id ID -e |
最初の5分 |
| アプリを一括更新する | winget upgrade で確認 → winget upgrade --all |
一括更新とピン留め |
| 入っているアプリの一覧 | winget list |
list・uninstall |
| アプリを削除する | winget uninstall --id ID -e |
list・uninstall |
| 新しい PC に同じアプリを入れる | winget export -o apps.json → winget import -i apps.json |
export・import |
| 「winget は認識されていません」と出る | アプリ インストーラーを入れ直す・実行エイリアスと PATH を確かめる | エラーとつまずき |
| Chocolatey・Scoop との違い | 提供元・カタログ・入れ方が違う。使う場面で選ぶ | Chocolatey・Scoop との違い |
確認環境:この記事は Windows の実機で winget を動かして書いたものではありません。コマンド・オプション・挙動は、Microsoft Learn の winget のページ(install・upgrade・list・uninstall・search・export・import・source・pinning・settings・troubleshooting・マニフェストのリファレンス)と、公式の GitHub リポジトリ microsoft/winget-cli のトラブルシューティングの文書・リリースの一覧で、1つずつ確かめた範囲だけを書いています。画面の名前を「」で書いたものは、取得した公式の文面にそのまま出ていた語だけです。版によって画面の名前が違う場合があります。手元で実際に動かしたのは、公式リポジトリから取得したスキーマ(マニフェストの manifest.singleton.1.12.0.json、export/import の packages.schema.2.0.json)を使った YAML・JSON の検証、エラーコードの一覧(returnCodes.md、文書の日付 2026年5月13日)の16進・10進の照合、インストーラーの SHA256 の計算、照合の規則とピン留めの版の範囲の再現です。環境は Ubuntu 24.04.5 LTS・Python 3.13.18・PyYAML 6.0.3・jsonschema 4.26.0。この環境には PowerShell も winget も入っていないため、winget と PowerShell のコマンドは公式の記載どおりに並べたもので、実行結果ではありません。図は mermaid で描画を確かめています(確認日 2026年11月13日)。
本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。
(記載例)出典:株式会社RJC「wingetとは|使い方・コマンド一覧とupgrade --allでアプリ一括更新」
wingetとは(Windows パッケージ マネージャーとアプリ インストーラー)
この節では、winget が何をする道具で、何という名前で配られているのかが分かります。
winget は「Windows パッケージ マネージャー」のコマンドライン ツールです。 Microsoft Learn(日本語版)は、WinGet を「Windows 10、Windows 11、Windows Server 2025 を搭載したコンピューター上でアプリケーションを検索し、install、アップグレード、削除、設定できるようにするコマンド ライン ツール」で、「Windows パッケージ マネージャー サービスへのクライアント インターフェイス」だと説明しています。読み方は公式には示されていません。表記は Microsoft Learn では「WinGet」、コマンドとしては小文字の winget です。
winget 単体のインストーラーがあるわけではなく、「アプリ インストーラー」(App Installer)という Windows の部品の一部として配られます。アプリ インストーラーは、Windows のデスクトップ版では Microsoft Store から、Windows Server 2025 では更新プログラムから配信・更新されるシステム コンポーネントです。中身はオープンソースで、GitHub の microsoft/winget-cli で開発されています。公式の GitHub のリリース一覧では、2026年11月13日時点の安定版(Latest)は 1.29.290、プレビュー版は 1.30.100-preview でした。
ふだんの意味と、winget での意味
winget の説明には、ふだんの言葉と同じ語が別の意味で出てきます。先に並べておきます。
| 言葉 | ふだんの意味 | winget での意味 |
|---|---|---|
| パッケージ | 包み・パック旅行のひとまとめ | 1つのアプリと、その版・入れ方の情報のひとまとめ |
| マネージャー | 管理する人 | 入れる・更新する・消すを受け持つ道具 |
| ソース | 調味料・出どころ | パッケージの情報を取りに行く置き場所(winget・msstore など) |
| マニフェスト | 積荷の目録・政党の公約 | パッケージの名前・版・URL・ハッシュを書いた YAML ファイル |
| ピン留め(pin) | 画鋲で留める | 一括更新の対象から外す・版を固定する設定 |
| モニカー | あだ名 | 短い呼び名。search や install の検索で当たる |
winget が使えるか確かめる・入っていないときの入れ方(Windows 11・10 の違い)
この節では、自分の PC で winget が使えるかの確かめ方と、使えないときの入れ方が分かります。
ターミナル(PowerShell かコマンド プロンプト)で winget --version を打ち、版の番号が出れば使えます。 詳しい情報(ログの場所・グループ ポリシーの状態など)は winget --info で出ます。
winget --version
winget --info
Microsoft Learn によると、winget は Windows 11 と最新の Windows 10 でアプリ インストーラーの一部として使えます。Windows 10 はバージョン 1809(ビルド 17763)以降だけが対象です。
| 項目 | Windows 11 | Windows 10 |
|---|---|---|
| 使えるか | アプリ インストーラーの一部として使える | 1809(ビルド 17763)以降で使える |
| 入っていないとき | Microsoft Store でアプリ インストーラーを入れる | 同じ |
| 初回サインインの直後に無い | Store の登録が済むまで使えないことがある(下のコマンドで登録) | 同じ |
| 壊れたときのリセット(公式のトラブルシューティング) | Reset-AppxPackage を使う手順 |
Add-AppxPackage -Register で登録し直す手順 |
| コマンドとオプション | 同じ | 同じ |
サインインしてすぐは、Microsoft Store がパッケージを登録するまで winget が使えないことがあります。Microsoft Learn は、その場合に PowerShell で次の1行を実行する方法を載せています。
Add-AppxPackage -RegisterByFamilyName -MainPackage Microsoft.DesktopAppInstaller_8wekyb3d8bbwe
Microsoft Store が使えない Windows サンドボックスなどでは、PowerShell ギャラリーの Microsoft.WinGet.Client モジュールを入れ、Repair-WinGetPackageManager で winget を用意する方法が公式に載っています。会社の PC で Store やモジュールの取得が止められている場合は、自分で回り道をせず、PC の管理者に入れ方を確かめるのが確実です。
最初の5分:winget の使い方(検索→詳細→インストール→確認)
この節では、winget でアプリを1つ入れるまでの最小の手順が分かります。
ターミナルを開く
スタート メニューから PowerShell かターミナルを開きます。管理者として開く必要は、たいていありません。管理者の権限が要るインストーラーは、実行の途中で確認が出ます。
探す:winget search
winget search vscode のように打つと、名前・ID・モニカーなどに文字が含まれるパッケージが並びます。入れるときに使うのは「ID」の列です。
中身を見る:winget show
winget show --id Microsoft.VisualStudioCode -e で、提供元・ライセンス・公式サイト・選ばれるインストーラーを確かめます。提供元が思っていたものと同じかをここで見ます。
入れる:winget install --id ID -e
ID と -e(--exact)を組み合わせると、1つに確実に絞れます。winget がインストーラーを取得し、ハッシュを確かめてから実行します。
確かめる:winget list
winget list --id Microsoft.VisualStudioCode で、入った版が表示されます。
winget search vscode
winget show --id Microsoft.VisualStudioCode -e
winget install --id Microsoft.VisualStudioCode -e
winget list --id Microsoft.VisualStudioCode
一度に複数のアプリを入れるときは、ID を空白で区切って並べます。Microsoft Learn の例は次のとおりで、winget は1つずつ順番に入れます。
winget install Microsoft.VisualStudioCode Microsoft.PowerShell Git.Git
PowerShell 自体を winget で入れる手順と、PowerShell のコマンドの全体像は、関連記事「PowerShellコマンド一覧|用途別50選とbash対応表・実行例付き」で扱っています。コマンド プロンプトの開き方は、当ブログの記事「コマンドプロンプトの開き方・使い方|ショートカットとコマンド一覧・bash対応表」でもまとめています。
winget コマンド一覧(全サブコマンドと共通オプション)
この節では、winget のサブコマンドとよく使うオプションを、一覧で引けるようになります。
Microsoft Learn の一覧にあるサブコマンドは18個です。 日常で使うのは上の8つで、残りはパッケージを作る人・管理する人向けです。
| コマンド | 別名 | すること | 例 |
|---|---|---|---|
search | find | ソースからアプリを探す | winget search vscode |
show | アプリの詳細と選ばれるインストーラーを表示 | winget show --id Git.Git -e | |
install | add | アプリを入れる | winget install --id Git.Git -e |
list | ls | 入っているアプリの一覧(winget 以外で入れたものも) | winget list |
upgrade | update | 更新。引数なしなら更新できるアプリの一覧 | winget upgrade --all |
uninstall | remove・rm | アプリを消す | winget uninstall --id Git.Git -e |
export | 入っているアプリの一覧を JSON に書き出す | winget export -o apps.json | |
import | JSON に書いたアプリをまとめて入れる | winget import -i apps.json | |
source | ソースの一覧・更新・追加・削除・初期化 | winget source list | |
pin | ピン留め(一括更新から外す・版を固定) | winget pin list | |
settings | 設定(settings.json)を開く | winget settings | |
features | 試験的な機能の状態を表示 | winget features | |
download | インストーラーをダウンロードだけする | ID を指定して実行 | |
repair | 選んだアプリを修復する | ID を指定して実行 | |
hash | インストーラーの SHA256 を計算 | インストーラーのファイルを指定 | |
validate | マニフェストを提出前に検証 | マニフェストを指定 | |
configure | 構成ファイルのとおりにシステムを整える | 構成ファイルを指定 | |
dscv3 | PowerShell DSC v3 のリソース用のコマンド | DSC から使う |
どのコマンドにも付けられる共通のオプションと、install・upgrade でよく使うオプションをまとめます。
| オプション | 意味 | 使う場面 |
|---|---|---|
-v・--version | 単独なら winget の版。install では入れるアプリの版 | 版を指定して入れる |
--id・-e(--exact) | ID だけで探す・大文字小文字も含めて完全一致 | 1つに絞る |
-s・--source | ソースを限る(winget・msstore など) | 同じ名前が複数のソースにある |
--scope | user(自分だけ)か machine(PC 全体) | 入れる範囲を決めたい |
-h・--silent | インストーラーの画面を出さない | まとめて入れる |
-i・--interactive | インストーラーの画面を出して選びながら入れる | 入れる場所や部品を選びたい |
-l・--location | 入れる場所(インストーラーが対応していれば) | 入れる先を変えたい |
--accept-package-agreements | パッケージの使用許諾に同意して確認を出さない | スクリプトで入れる |
--accept-source-agreements | ソースの利用条件に同意して確認を出さない | スクリプトで入れる |
--disable-interactivity | 対話の確認を出さない | 自動化 |
--verbose-logs・--logs | 詳しいログを残す・ログの場所を開く | 失敗の原因を調べる |
--proxy・--no-proxy | その回だけプロキシを使う・使わない | 社内ネットワーク |
Microsoft Learn によると、--accept-package-agreements はパッケージ自身の使用許諾にだけ効き、インストーラーが勧める別のソフトや追加の部品には関係しません。画面を一切出さずに入れたいときは --silent と組み合わせる、と書かれています。同意を自動にする前に、winget show でライセンスの記載を一度読んでおくと安心です。機密情報や商用での利用に関わるアプリは、提供元の最新の利用条件と所属先の決まりを先に確かめます。
winget の ID の指定と --exact:1つに絞れないときの直し方
この節では、「複数のパッケージが見つかりました」となる理由と、確実に1つに絞る指定の仕方が分かります。
winget の検索は、既定では「大文字小文字を区別しない部分一致」です。 Microsoft Learn によると、検索の文字は名前・ID・モニカーと照らし合わされ、ワイルドカード(*)は使えません。-e(--exact)を付けると、大文字小文字も含めた完全一致になります。install・upgrade・uninstall は1つに決まらないと先に進まず、候補を表示して絞り込みを求めます。
この規則を、架空のパッケージ5つで再現しました(Python で書いた再現で、winget 本体の動作ではありません)。公式の説明にある「micro で検索すると Microsoft・Microscope・MyMicro が当たりうる」という例に合わせています。
pk = [
('Microsoft Sample Editor', 'Contoso.SampleEditor', 'sampleedit'),
('Microscope Viewer', 'Fabrikam.Microscope', 'microscope'),
('MyMicro', 'Contoso.MyMicro', 'mymicro'),
('Notepad Micro', 'Fabrikam.NotepadMicro', None),
('MyMicro Pro', 'Contoso.MyMicroPro', None),
]
def search(q, exact=False, field=None):
out = []
for name, pid, mon in pk:
cands = {'name': [name], 'id': [pid], 'moniker': [mon] if mon else []}
vals = cands[field] if field else sum(cands.values(), [])
if any((v == q) if exact else (q.lower() in v.lower()) for v in vals):
out.append(pid)
return out
query='micro' -> 5件 ['Contoso.SampleEditor', 'Fabrikam.Microscope', 'Contoso.MyMicro', 'Fabrikam.NotepadMicro', 'Contoso.MyMicroPro']
query='MICRO' -> 5件 ['Contoso.SampleEditor', 'Fabrikam.Microscope', 'Contoso.MyMicro', 'Fabrikam.NotepadMicro', 'Contoso.MyMicroPro']
query='Contoso.MyMicro' --id -> 2件 ['Contoso.MyMicro', 'Contoso.MyMicroPro']
query='contoso.mymicro' --id -e -> 0件 []
query='Contoso.MyMicro' --id -e -> 1件 ['Contoso.MyMicro']
query='Contoso' --id -> 3件 ['Contoso.SampleEditor', 'Contoso.MyMicro', 'Contoso.MyMicroPro']
1--id だけでは絞り切れない
部分一致なので、Contoso.MyMicro は Contoso.MyMicroPro にも当たった。ID が別の ID の頭と同じだと2件になる。
2-e は大文字小文字も見る
すべて小文字で打つと0件になった。ID は winget search の表示をそのまま写す。
3--id と -e の組み合わせで1件
公式も「ID と exact の組み合わせが、1つを選ぶいちばんよい方法」としている。
同じ ID が複数のソースに出るときは、--source winget のようにソースも指定します。Microsoft Store(msstore)のパッケージは XP9KHM4BK9FZ7Q のような英数字の ID で、公式によるとこの ID は重ならないため -e が要りません。
- 1名前で探す → winget search 名前ID の列を写し取る
- 2ID で指定する → --id ID頭が同じ別の ID があると、まだ複数になる
- 3完全一致にする → --id ID -e大文字小文字まで同じに打つ
- 4ソースも決める → --source wingetmsstore と winget の両方に出るとき
- 5版も決める → --version 版チームで版をそろえるとき
なお、winget search を検索語なしで打っても、以前の版のように全件は出ません。Microsoft Learn は、全件を出したいときは winget search --query "" と書く、としています(Windows PowerShell では引用符をエスケープした winget search -q `"`")。
winget upgrade --all でアプリを一括更新する(ピン留めと更新されないアプリ)
この節では、winget でアプリをまとめて更新する手順と、一括更新でも更新されないアプリの理由が分かります。
まず winget upgrade(引数なし)で更新できるアプリを一覧し、内容を見てから winget upgrade --all で更新します。 Microsoft Learn も、--all の前に引数なしの upgrade で、何が更新されるかを先に確かめるよう書いています。winget update は upgrade の別名で、同じ動きです。
winget upgrade
winget upgrade --id Microsoft.PowerToys -e
winget upgrade --all
winget upgrade --all --include-unknown
一括更新の進め方
winget upgrade --all --silent を実行し、作業中のアプリや、版を合わせているツールまで上げてしまうwinget upgrade で一覧を見る → 上げたくないものを winget pin add で外す → 作業中のアプリを閉じて --all開いているアプリは更新に失敗しやすい(公式のエラー表に「アプリが実行中」がある)
一括更新で更新されないアプリ
| 理由 | 何が起きているか | 対処(公式の記載) |
|---|---|---|
| 版が分からないアプリ | アプリが版を出さないため、新しい版があるか判定できない | --include-unknown(-u)を付ける |
| ピン留めしたアプリ | --all の対象から外れる |
--include-pinned を付ける(ブロックのピンは外れない) |
| winget のカタログに無いアプリ | list には出ても、更新の元が見つからない |
アプリ自身の更新機能か提供元の案内で更新する |
| Microsoft Store の利用条件に未同意 | msstore のソースが使えない | 同意するか --source winget に限る |
ピン留め(winget pin)の3種類
更新したくないアプリは winget pin add で外せます。 Microsoft Learn によると、ピンには次の3種類があります。ピン留めは winget からの更新を止めるだけで、アプリ自身の自動更新は止めません。
| 種類 | 付け方 | upgrade --all | upgrade ID |
|---|---|---|---|
| ピン(既定) | winget pin add ID | 外れる(--include-pinned で含める) | 更新できる |
| ブロック | --blocking を付ける | 外れる | 外れる(ピンを外すか --force) |
| ゲート(版の範囲) | --version 1.2.* | 範囲の外へは上げない | 範囲の外へは上げない |
ゲートの 1.2.* は、公式の説明では「1.2.0 から 1.2.x までが有効」です。この範囲の考え方を Python で再現すると、次のようになります(winget 本体の実装ではありません)。
1.2.* -> 1.1.9:止 1.2.0:可 1.2.7:可 1.2.10:可 1.3.0:止 1.20.0:止 2.0.0:止
1.* -> 1.1.9:可 1.2.0:可 1.2.7:可 1.2.10:可 1.3.0:可 1.20.0:可 2.0.0:止
1.2.7 -> 1.1.9:止 1.2.0:止 1.2.7:可 1.2.10:止 1.3.0:止 1.20.0:止 2.0.0:止
文字列で比べたとき 1.2.10 > 1.2.7 ? False / 数で比べたとき True
版は「文字」ではなく「区切りごとの数」で比べます。 文字として比べると 1.2.10 が 1.2.7 より小さいと判定されました。PowerShell や Python で winget の出力を並べ替えるスクリプトを書くときは、この取り違えに気をつけます。
winget pin add --id Microsoft.PowerToys
winget pin add --id Microsoft.PowerToys --blocking
winget pin add --id Microsoft.PowerToys --version 0.70.*
winget pin list
winget pin remove --id Microsoft.PowerToys
winget list・uninstall:入っているアプリの確認と削除
この節では、入っているアプリの一覧の出し方と、winget でアプリを消す方法が分かります。
winget list は、winget で入れたアプリだけでなく、ほかの方法で入れたアプリも表示します。 更新がある場合は、その版と、更新の取得元のソースも表示されます。更新があるものだけを見たいときは winget list --upgrade-available、1つの詳細を見たいときは --details を付けます。
winget list
winget list git
winget list --upgrade-available
winget list --id Microsoft.VisualStudioCode --details
アプリを消すのは winget uninstall です。 公式によると、list に出ていれば winget 以外で入れたアプリも消せます。版を指定しなければ、いちばん高い版が対象です。
winget uninstall --id Microsoft.PowerToys -e
winget uninstall --id Microsoft.PowerToys -e --source winget
Microsoft Learn は、ソースの問い合わせ方の都合で、アンインストールのときに Microsoft Store の利用条件の確認が出ることがあると書いています。避けたいときは --source winget を付けるか、Windows の設定のアプリの画面から消します。ポータブル(インストーラーを使わない)パッケージは、--purge で置き場所のファイルごと消し、--preserve でアプリが作ったファイルを残せます。
winget のソース(winget・msstore・winget-font)と利用条件
この節では、winget がどこからパッケージの情報を取ってくるのかと、ソースの扱い方が分かります。
既定のソースは3つで、ふだん検索の対象になるのは winget と msstore です。 Microsoft Learn の winget source list の出力例は次のとおりです。
Name Argument Explicit
------------------------------------------------------------------
msstore https://storeedgefd.dsx.mp.microsoft.com/v9.0 false
winget https://cdn.winget.microsoft.com/cache false
winget-font https://cdn.winget.microsoft.com/fonts true
| ソース名 | 中身 | 既定で検索される |
|---|---|---|
winget | WinGet コミュニティ リポジトリ(アプリ) | はい |
msstore | Microsoft Store のカタログ | はい |
winget-font | WinGet コミュニティ リポジトリ(フォント) | いいえ(--source で指定したときだけ) |
winget のコミュニティ リポジトリは GitHub の microsoft/winget-pkgs で、パッケージの情報(マニフェスト)はここに集まります。ソースの中には、使う前に利用条件への同意を求めるものがあり、同意しないとそのソースは使えません。利用条件が変わったときや、ソースを消して入れ直したときは、もう一度確認が出ます。
winget source list
winget source update
winget source reset --force
ソースの追加(add)・削除(remove)・初期化(reset)には管理者の権限が要ります。reset --force は既定のソース以外を消して最初の状態に戻すもので、公式は「まれな場合にだけ」使うよう書いています。ソースは信頼できるものだけを使う、というのが公式の注意です。
ソースの情報は自動で更新されます。settings.json の source.autoUpdateIntervalInMinutes が更新の間隔(分)で、既定は15分、0 で自動の確認をやめます。手で更新するときは winget source update です。
winget export・import で一括インストールする(JSON の形を検証)
この節では、今の PC のアプリを書き出して、別の PC にまとめて入れる手順と、その JSON の正しい形が分かります。
winget export -o apps.json で一覧を書き出し、新しい PC で winget import -i apps.json を実行すると、書いてあるアプリを順番に入れます。 書き出されるのは、ソースのパッケージと照らし合わせられたアプリだけで、照らし合わせられないアプリは警告が出ます。アプリの設定や作ったファイルは含まれません。
winget export -o apps.json
winget export -o apps.json --include-versions
winget import -i apps.json --accept-package-agreements --accept-source-agreements
winget import -i apps.json --ignore-unavailable --ignore-versions
| オプション | コマンド | 意味 |
|---|---|---|
--include-versions | export | 今の版も書き出す(既定では import は最新を入れる) |
-s・--source | export | 特定のソースのアプリだけ書き出す |
--ignore-unavailable | import | 見つからないアプリがあってもエラーにしない |
--ignore-versions | import | JSON の版を無視して最新を入れる |
--no-upgrade | import | 入っているアプリは更新しない |
JSON の形(スキーマ 2.0)を手元で検証した
Microsoft Learn には JSON の完全な例が無いため、公式リポジトリのスキーマ(packages.schema.2.0.json)を取得し、その項目どおりに手で作った見本を jsonschema で検証しました。実際の export の出力ではありません。必須はいちばん外側の Sources で、パッケージはソースごとの Packages の中に入ります。
{
"CreationDate": "2026-11-13T10:00:00.000+09:00",
"Sources": [
{
"Packages": [
{ "PackageIdentifier": "Git.Git" },
{ "PackageIdentifier": "Microsoft.VisualStudioCode" },
{ "PackageIdentifier": "Microsoft.PowerShell" },
{ "PackageIdentifier": "Microsoft.PowerToys", "Version": "0.91.1" }
],
"SourceDetails": {
"Argument": "https://cdn.winget.microsoft.com/cache",
"Identifier": "Microsoft.Winget.Source_8wekyb3d8bbwe",
"Name": "winget",
"Type": "Microsoft.PreIndexed.Package"
}
}
],
"WinGetVersion": "1.29.290"
}
この見本(pcA.json)と、2つだけ入った別の見本(pcB.json)を検証し、よくある書き間違いも試した結果です。
[pcA.json] OK(エラー 0 件)
[pcB.json] OK(エラー 0 件)
[Packages を直下に書いた]
(root) (required) 'Sources' is a required property
[Packages が空]
Sources/0/Packages (minItems) [] should be non-empty
[Id と書いた]
Sources/0/Packages/0 (required) 'PackageIdentifier' is a required property
[Scope が system]
Sources/0/Packages/3/Scope (enum) 'system' is not one of ['user', 'machine']
B に足りない: ['Microsoft.PowerToys', 'Microsoft.VisualStudioCode']
A に無い: []
--- 足りない分を1本ずつ入れるコマンド ---
winget install --id Microsoft.PowerToys -e --source winget --accept-package-agreements --accept-source-agreements
winget install --id Microsoft.VisualStudioCode -e --source winget --accept-package-agreements --accept-source-agreements
最後の3行は、2台の PC の export を比べて、片方に足りないアプリだけを入れるコマンドを Python で作ったものです。全部を入れ直さずに差分だけ入れたいときに使えます。スキーマで許される Scope は user と machine だけでした。
- 1export の警告を読む照らし合わせられなかったアプリは JSON に入らない。手で入れる一覧に控える
- 2要らないアプリを JSON から消す公式も、書き出した JSON を編集して入れたくないアプリを消せる、としている
- 3版をそろえるか決めるそろえるなら
--include-versions、最新でよければ付けない - 4設定とデータは別に移すアプリの設定や作ったファイルは export に入らない
Java の JDK を winget で入れる例と、配布元ごとのパッケージ ID は、関連記事「Java 25インストール(Windows)|JDK 25/27とJAVA_HOME」で扱っています。
winget のマニフェスト(YAML)の形と必須項目を検証する
この節では、winget のパッケージ情報であるマニフェストの中身と、書き間違えたときにどう検出されるかが分かります。
マニフェストは、パッケージの名前・版・インストーラーの URL・SHA256 のハッシュを書いた YAML ファイルです。 種類は、1ファイルにまとめる「singleton」と、version・defaultLocale・installer の3ファイル以上に分ける形があります。Microsoft Learn によると、1ファイル型はインストーラーと言語が1つずつのときだけ使えます。リポジトリの中では manifests/m/Microsoft/WindowsTerminal/1.6.10571.0/ のように、提供元の頭文字・提供元・パッケージ・版の順にフォルダーが分かれます。
必須の項目は次の10個です(スキーマ 1.12.0 の1ファイル型)。
| 項目 | 中身 | スキーマの決まり(1.12.0) |
|---|---|---|
| PackageIdentifier | 提供元.パッケージ の形の ID | 点で区切った2〜8個、各1〜32文字、空白不可、全体128文字まで |
| PackageVersion | 版 | 文字列、128文字まで |
| PackageLocale | 言語(BCP 47。ja-JP など) | 20文字まで |
| Publisher | 提供元の名前 | 2〜256文字 |
| PackageName | アプリの名前 | 2〜256文字 |
| License | ライセンス | 3〜512文字 |
| ShortDescription | 短い説明 | 3〜256文字 |
| Installers | インストーラーの一覧 | 1ファイル型はちょうど1つ。Architecture・InstallerUrl・InstallerSha256 が必須 |
| ManifestType | ファイルの種類 | 1ファイル型は singleton |
| ManifestVersion | 書式の版 | 1.12.0 など、数3つ |
架空のツール「Hello CLI」の1ファイル型マニフェストを作りました。ハッシュは、手元で作った1MBの見本ファイルを sha256sum で計算した値です(winget hash が行う計算と同じ SHA256)。URL は例示用のドメインで、実在のインストーラーではありません。
# yaml-language-server: $schema=https://aka.ms/winget-manifest.singleton.1.12.0.schema.json
PackageIdentifier: Example.HelloCli
PackageVersion: "1.10.0"
PackageLocale: ja-JP
Publisher: Example
PackageName: Hello CLI
License: MIT
ShortDescription: あいさつを表示するだけの見本のツール
Moniker: hellocli
Tags:
- sample
- cli
Installers:
- Architecture: x64
InstallerType: exe
InstallerUrl: https://example.com/hello-setup.exe
InstallerSha256: 4E29AD18AB9F42D7C233500771A39D7C852B200BAF328FD00FBBE3FECEA1EB56
InstallerSwitches:
Silent: /S
SilentWithProgress: /S
ManifestType: singleton
ManifestVersion: 1.12.0
1行目のコメントは、スキーマの $id(スキーマファイルに書かれた URL)をエディターの YAML 拡張機能に知らせるためのもので、なくても動きます。このファイルと、わざと1か所ずつ壊したものを、公式のスキーマで検証しました。
[見本そのまま] OK(エラー 0 件)
[ShortDescriptionなし] (root): (required) 'ShortDescription' is a required property
[IDに点がない] PackageIdentifier: (pattern) 'HelloCli' does not match '^[^\\.\\s\\\\/:\\*\\?"<>\\|\\x01- ... /:\\*\\?"<>\\|\\x01-\\x1f]{1,32}){1,7}$'
[ハッシュが63桁] Installers/0/InstallerSha256: (pattern) '4E29AD18AB9F42D7C233500771A39D7C852B200BAF328FD00FBBE3FECEA ... 1EB5' does not match '^[A-Fa-f0-9]{64}$'
[インストーラー2つ] Installers: (maxItems) [{'Architecture': 'x64', 'InstallerType': 'exe', 'InstallerU ... SilentWithProgress': '/S'}}] is too long
[アーキテクチャ名の誤り] Installers/0/Architecture: (enum) 'amd64' is not one of ['x86', 'x64', 'arm', 'arm64', 'neutral']
[URLがhttpでない] Installers/0/InstallerUrl: (pattern) 'ftp://example.com/a.exe' does not match '^([Hh][Tt][Tt][Pp][Ss]?)://.+$'
引用符なし 1.10 を読んだ値: 1.1
[バージョンを引用符なし] PackageVersion: (type) 1.1 is not of type 'string'
[キーのつづり違い] (root): (required) 'ShortDescription' is a required property
[Publisherが1文字] Publisher: (minLength) 'E' is too short
任意のキーのつづり違い Monikr: 0 件のエラー
PackageName を2回書いたときの値: 'Hello'
Python hashlib: 4E29AD18AB9F42D7C233500771A39D7C852B200BAF328FD00FBBE3FECEA1EB56 一致
スキーマで見つかった
必須項目の欠け・必須項目のつづり違い
ID の形・ハッシュの桁・URL の形・アーキテクチャ名
1ファイル型にインストーラーを2つ書いた
スキーマでは見つからなかった
任意の項目のつづり違い(Monikr はエラー0件)
同じキーを2回(PyYAML は後の値を黙って使った)
ハッシュの値が本物と合っているか
版の番号は引用符で囲むのが安全です。 PackageVersion: 1.10 と書くと、PyYAML は数の 1.1 として読み、文字列を求めるスキーマに合いませんでした。これは PyYAML と jsonschema で読んだ結果で、winget 自身の読み方とは別ですが、どのツールで読んでも文字列になるよう、公式の version ファイルの例と同じく引用符で囲んでおくと迷いません。Microsoft Learn は、項目名は先頭を大文字にする書き方(Pascal case)で重複させないこと、YAML のアンカー・複雑なキー・集合は使えないことも書いています。
実際にパッケージを登録するときは、公式は wingetcreate new か、winget-pkgs リポジトリの YAMLCreate.ps1 を使う方法を案内しています。提出前の確認は winget validate です。YAML の書き方そのものの落とし穴は、関連記事「YAMLの書き方|構文一覧とパース結果、落とし穴10例を実測」で扱っています。
winget のエラーとつまずき(認識されない・管理者権限・ログ・エラーコード)
この節では、winget でよく出るつまずきの原因と直し方、エラーコードの読み方が分かります。
「winget は認識されていません」と出る
公式リポジトリのトラブルシューティングには、英語の画面での表示が次のように載っています。日本語の Windows では日本語の文面で表示されます。
'winget' is not recognized as an internal or external command,
winget : The term 'winget' is not recognized as the name of a cmdlet, function, script file, or operable program.
同じ文書の直し方は次の順です。アプリ インストーラーの版を確かめ(1.11.11451 より新しいこと)、設定のアプリの画面にあるアプリ実行エイリアスで winget がオンになっているかを見て、PATH に %userprofile%\AppData\Local\Microsoft\WindowsApps が入っているかを確かめます。
Get-AppxPackage microsoft.desktopappinstaller
& "$env:LOCALAPPDATA\Microsoft\WindowsApps\winget" --version
2行目のように置き場所を直接指定して動くなら、PATH にその場所が入っていない可能性が高い、と公式は説明しています。
症状表
| 症状 | 原因 | 確かめ方 | 直し方 |
|---|---|---|---|
| winget が認識されない | アプリ インストーラーが無い・以前の版・エイリアスがオフ・PATH | Get-AppxPackage で版を見る | Store でアプリ インストーラーを更新・エイリアスと PATH を確かめる |
| winget が何も表示せずに終わる | 以前の版(1.6.3482 より前)が使っていた配信元の終了 | winget --info の版 | 最新のアプリ インストーラーを入れ、winget source update |
| 複数のパッケージが見つかる | 部分一致で複数に当たった | winget search の ID の列 | --id ID -e、必要なら --source |
| パッケージが見つからない | カタログに無い・ID の大文字小文字・-e の付けすぎ | winget search 名前の一部 | ID を表示どおりに写す |
| 同意の確認で止まる | ソースやパッケージの利用条件 | 表示された条件を読む | 読んだうえで --accept-* を付ける |
| ソースの更新に失敗する | cdn.winget.microsoft.com に届かない | winget source update | ネットワークとプロキシを確かめる(--proxy) |
| ダウンロードで 403 | 配布元が winget からの取得を断っている | ブラウザでは取得できるか | 提供元の案内で入れる |
| 0x801901a0・0x80d03002 | 配信の最適化(Delivery Optimization)まわり | --verbose-logs のログ | settings.json の network.downloader を wininet に |
| ポリシーでブロックされた | 組織のグループ ポリシー | winget --info | PC の管理者に相談する |
管理者権限とスコープ
Microsoft Learn によると、管理者の権限が要るインストーラーは、実行のときに Windows が管理者の権限を求める確認を出し、断るとインストールは失敗します。管理者として開いたターミナルで winget を使うと、この確認は表示されません。 公式は、その場合は注意して、信頼できるアプリだけを入れるよう書いています。ふだんは管理者でないターミナルで使い、確認が出たら内容を見て判断する方が、何が起きるかを把握できます。
--scope user・--scope machine の効き方はインストーラーの形式で違います。公式のトラブルシューティングでは、MSIX は確実、MSI はおおむね確実、EXE は決まった動きにならない(範囲の引数を持たないものもある)と説明されています。また、winget のコマンドは SYSTEM アカウント(NT AUTHORITY\SYSTEM)では使えず、その場合は PowerShell の Microsoft.WinGet.Client モジュールを使う、とされています。
ログの場所
winget はコマンドごとにログを残します。既定の場所は次のとおりで、winget --info でも確かめられます。7日より前のもの、合計128MBを超えた分は自動で消され、1ファイルは16MBで切り替わります。
%LOCALAPPDATA%\Packages\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe\LocalState\DiagOutputDir
失敗した原因を調べるときは、コマンドに --verbose-logs を付けて詳しいログを残し、--logs でログの場所を開きます。
エラーコードの読み方(16進と10進)
winget のエラーは 0x8A15xxxx の形の番号で表され、winget error 番号 で説明を表示できます。 公式リポジトリの一覧(returnCodes.md)には203件が載っています。同じコードが、ログやスクリプトでは負の10進数で出ることがあるため、Python で16進・10進を相互に変換して、一覧の全件と照らし合わせました。
def to_dec(h):
n = int(h, 16); return n - (1 << 32) if n >= 1 << 31 else n
def to_hex(d):
return '0x%08X' % (d & 0xFFFFFFFF)
表の行数: 203 / 16進と10進が一致: 203
0x8A150014 -> 0x8A150014 / -1978335212 / APPINSTALLER_CLI_ERROR_NO_APPLICATIONS_FOUND
-1978335212 -> 0x8A150014 / -1978335212 / APPINSTALLER_CLI_ERROR_NO_APPLICATIONS_FOUND
0x8A15002B -> 0x8A15002B / -1978335189 / APPINSTALLER_CLI_ERROR_UPDATE_NOT_APPLICABLE
-1978335162 -> 0x8A150046 / -1978335162 / APPINSTALLER_CLI_ERROR_SOURCE_AGREEMENTS_NOT_ACCEPTED
2316632084 -> 0x8A150014 / -1978335212 / APPINSTALLER_CLI_ERROR_NO_APPLICATIONS_FOUND
最後の行のように、符号なしの10進数(2316632084)で表示された場合も、同じ 0x8A150014 に戻せます。よく出るコードを一覧から抜き出しました。
| 16進 | 10進 | 一覧の説明(公式) |
|---|---|---|
| 0x8A150011 | -1978335215 | インストーラーのハッシュがマニフェストと合わない |
| 0x8A150014 | -1978335212 | パッケージが見つからない |
| 0x8A150016 | -1978335210 | 条件に合うパッケージが複数ある |
| 0x8A15002B | -1978335189 | 当てはまる更新が無い |
| 0x8A15002C | -1978335188 | upgrade --all は終わったが失敗がある |
| 0x8A150046 | -1978335162 | ソースの利用条件に同意していない |
| 0x8A150068 | -1978335128 | ピンがあるため更新できない |
| 0x8A150101 | -1978334975 | アプリが実行中(閉じてからやり直す) |
ハッシュが合わないエラー(0x8A150011)は、取得したインストーラーがマニフェストに書かれたものと違うことを示します。install には照合の失敗を無視するオプションもありますが、公式の説明でも「推奨しない」とされています。使わずに、時間をおいてやり直すか、提供元の配布ページで公式の入れ方を確かめます。
Linux の apt と同じ考え方で比べたいときは、関連記事「aptコマンド一覧|updateとupgradeの違い・apt-getとの違い」が対応表として使えます。apt の update(一覧の更新)に近いのは winget の source update、apt の upgrade に近いのは winget upgrade --all です。Mac の Homebrew については、当ブログの記事「Homebrewとは・使い方|Macインストール手順とbrewコマンド一覧」でまとめています。
winget と Chocolatey・Scoop との違い
この節では、Windows で使われるほかのパッケージ管理と winget の違いを、各提供元の説明で並べます。
3つとも、コマンドでアプリを入れる・更新するための道具です。 違いは、誰が提供しているか、どのカタログから入れるか、どう入れるかです。どれが優れているかではなく、使う場面と所属先の決まりで選びます。
| 項目 | winget | Chocolatey | Scoop |
|---|---|---|---|
| 提供元の説明 | Windows パッケージ マネージャーのコマンド ライン ツール(Microsoft) | Windows のソフトウェア管理のためのパッケージ マネージャー | Windows のコマンドライン インストーラー |
| 入れ方 | アプリ インストーラーの一部として Windows に付属・Store で更新 | 公式サイトの PowerShell のコマンドで入れる | 管理者でない PowerShell で、公式 README のコマンドで入れる |
| 主なカタログ | WinGet コミュニティ リポジトリ・Microsoft Store | Chocolatey Community Repository | bucket(既定は main、追加で extras など) |
| パッケージの形 | YAML のマニフェスト | NuGet のパッケージの仕組みを使う | 公式 README の範囲では書いていない |
| 管理者の権限 | インストーラーが求めるときだけ確認が出る | 公式は、ほとんどのソフトは管理者の権限が要るとしている | UAC の確認を出さないことを目指すと説明。既定の置き場所はユーザーのフォルダー |
| 一括更新 | winget upgrade --all | choco upgrade all | 公式 README の範囲では書いていない |
表の内容は、Microsoft Learn・Chocolatey の公式ドキュメント・Scoop の公式リポジトリの README(いずれも2026年11月13日時点)に書かれていることだけです。組み合わせて使う場合は、同じアプリを2つの道具で入れると、どちらが更新を受け持つのか分かりにくくなる点に気をつけます。
判断表:winget を使う場面・ほかの方法を選ぶ場面
この節では、どの場面で winget を使い、どの場面で別の方法を選ぶかの目安が分かります。
| 場面 | おすすめの方法 | 理由 |
|---|---|---|
| 開発用のアプリを数本入れたい | winget install --id ID -e を並べる | 配布ページを探す手間が無い |
| 入っているアプリをまとめて更新したい | winget upgrade → --all | 更新の有無を1画面で見られる |
| PC の入れ替えで同じアプリをそろえたい | export → JSON を編集 → import | 一覧がファイルとして残る |
| チームで版をそろえたい | --version と winget pin(ゲート) | 勝手に上がらない |
| カタログに無いアプリ | 提供元の公式の入れ方 | winget では見つからない |
| 会社の管理下の PC | 管理者の決めた方法(ポリシーに従う) | グループ ポリシーで止められていることがある |
| 入れる部品や場所を細かく選びたい | winget install -i か、提供元のインストーラー | 既定では画面を省いて入れる |
| 開発環境ごと再現したい | winget configure の構成ファイル(公式の構成の説明に沿う) | アプリ以外の設定も扱える |
winget で入れられる便利なツールの例として、PowerToys の入れ方と全機能は、関連記事「PowerToysとは・使い方|全31ツール一覧と既定ショートカット46件」で扱っています。
wingetのよくある質問
Q. winget とは何ですか? A. Microsoft が提供する Windows パッケージ マネージャーのコマンドです。アプリの検索・インストール・更新・削除をコマンドで行えます。アプリ インストーラーの一部として Windows 11 と Windows 10(1809 以降)で使えます。
Q. winget は無料ですか?
A. winget 自体はアプリ インストーラーの一部として配られ、ソースコードは GitHub で公開されています。入れるアプリにはそれぞれのライセンスがあるため、winget show で確かめます。
Q. winget update と winget upgrade の違いは?
A. 同じです。Microsoft Learn では update は upgrade の別名として載っています。
Q. winget upgrade --all で更新されないアプリがあるのはなぜですか?
A. 版を判定できないアプリ(--include-unknown で含める)、ピン留めしたアプリ(--include-pinned)、winget のカタログに無いアプリは対象になりません。
Q. winget で入れたアプリはどこに入りますか?
A. 入る場所はアプリのインストーラーが決めます。--location で指定できるのは、インストーラーが対応している場合だけです。
Q. winget のコマンドは管理者として実行するべきですか? A. ふだんは管理者でないターミナルで使えます(権限が要るときは、その場で確認が出ます)。管理者のターミナルでは権限を求める確認が表示されなくなるため、公式は信頼できるアプリだけを入れるよう注意しています。
Q. Microsoft Store のアプリも winget で入れられますか?
A. msstore ソースのアプリを入れられます。winget install ID -s msstore のように、ソースを指定すると確実です。
Q. winget search で何も出なくなりました。
A. 検索語なしの winget search は、いまの版では全件を出しません。全件を出すなら winget search --query "" です。
Q. export に出てこないアプリがあります。 A. ソースのパッケージと照らし合わせられなかったアプリは書き出されず、警告が出ます。そのアプリは提供元の方法で入れます。
Q. winget 自体を更新するには?
A. Microsoft Store でアプリ インストーラーを更新します。版は winget --version で確かめられます。
Q. Linux や Mac でも winget は使えますか? A. Microsoft Learn の対象は Windows 10・Windows 11・Windows Server 2025 です。Linux なら apt や dnf、Mac なら Homebrew など、それぞれの OS のパッケージ管理を使います。
まとめ
- winget は Microsoft の Windows パッケージ マネージャーのコマンド。アプリ インストーラーの一部で、Windows 11 と Windows 10(1809 以降)で同じように使える。
- 入れるときは
winget searchで ID を調べ、winget showで中身を見てからwinget install --id ID -e。部分一致の検索で複数に当たるのを、ID と-eで防ぐ。 - 一括更新は
winget upgradeで一覧を見てから--all。版が分からないアプリ・ピン留めしたアプリは対象外で、上げたくないものはwinget pinで外す。 - export/import の JSON は、スキーマ 2.0 では
Sourcesが必須で、パッケージはソースごとのPackagesに入る。マニフェストの YAML は必須10項目で、版は引用符で囲むと迷わない。任意の項目のつづり違いはスキーマでは見つからなかった。 - つまずいたら、アプリ インストーラーの版・実行エイリアス・PATH を確かめ、
--verbose-logsのログとwinget error 番号で原因を読む。16進と10進のエラーコードは相互に変換できる。
参考・出典
いずれも確認日は2026年11月13日です。
- Microsoft Learn「WinGet を使用して install し、アプリケーションを管理する」:https://learn.microsoft.com/ja-jp/windows/package-manager/winget/
- Microsoft Learn「install command (winget)」:https://learn.microsoft.com/en-us/windows/package-manager/winget/install
- Microsoft Learn「upgrade command (winget)」:https://learn.microsoft.com/en-us/windows/package-manager/winget/upgrade
- Microsoft Learn「list command (winget)」:https://learn.microsoft.com/en-us/windows/package-manager/winget/list
- Microsoft Learn「uninstall command (winget)」:https://learn.microsoft.com/en-us/windows/package-manager/winget/uninstall
- Microsoft Learn「search command (winget)」:https://learn.microsoft.com/en-us/windows/package-manager/winget/search
- Microsoft Learn「export command (winget)」:https://learn.microsoft.com/en-us/windows/package-manager/winget/export
- Microsoft Learn「import command (winget)」:https://learn.microsoft.com/en-us/windows/package-manager/winget/import
- Microsoft Learn「source command (winget)」:https://learn.microsoft.com/en-us/windows/package-manager/winget/source
- Microsoft Learn「pin command (winget)」:https://learn.microsoft.com/en-us/windows/package-manager/winget/pinning
- Microsoft Learn「settings command (winget)」:https://learn.microsoft.com/en-us/windows/package-manager/winget/settings
- Microsoft Learn「Debugging and troubleshooting (winget)」:https://learn.microsoft.com/en-us/windows/package-manager/winget/troubleshooting
- Microsoft Learn「Windows Package Manager Manifest Reference」:https://learn.microsoft.com/en-us/windows/package-manager/package/manifest
- GitHub microsoft/winget-cli「Troubleshooting」:https://github.com/microsoft/winget-cli/blob/master/doc/troubleshooting/README.md
- GitHub microsoft/winget-cli「WinGet HRESULT Codes」(returnCodes.md):https://github.com/microsoft/winget-cli/blob/master/doc/windows/package-manager/winget/returnCodes.md
- GitHub microsoft/winget-cli のスキーマ(manifest.singleton.1.12.0.json・packages.schema.2.0.json):https://github.com/microsoft/winget-cli/tree/master/schemas/JSON
- GitHub microsoft/winget-cli「Releases」:https://github.com/microsoft/winget-cli/releases
- Chocolatey「Getting Started」:https://docs.chocolatey.org/en-us/getting-started/
- Chocolatey「Upgrade - choco upgrade」:https://docs.chocolatey.org/en-us/choco/commands/upgrade/
- GitHub ScoopInstaller/Scoop(README):https://github.com/ScoopInstaller/Scoop
本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。
(記載例)出典:株式会社RJC「wingetとは|使い方・コマンド一覧とupgrade --allでアプリ一括更新」
株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。
WE ARE HIRING
RJCで一緒に開発しながら、
成長を楽しみませんか?
RJCは、Web・モバイル・AIを活用した開発プロジェクトで、テックリードやPM・PMOも活躍するシステム開発会社です。会社を知る、待遇を確かめる、話を聞いてみる。気になるところ見てみてください!
- 127日年間休日
- 12時間平均残業時間
- 毎日ガチャ遊びココロも大切にする福利厚生。アマギフなどの賞品ラインナップ!
ほかにも、チケットレストラン、書籍読み放題、2年ごとの慰労報奨(休暇 or 金一封)、11期連続の黒字決算。