結論

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 との違い

2026年11月13日更新|Microsoft Learn と winget-cli の公式リポジトリで確認・スキーマ検証は Python 3.13 で実行

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 の検索で当たる
18個サブコマンドMicrosoft Learn の一覧(install〜dscv3)
10項目マニフェストの必須項目1ファイル型・スキーマ 1.12.0
203件公式のエラーコード表16進と10進を全件照合して一致

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つ入れるまでの最小の手順が分かります。

1

ターミナルを開く

スタート メニューから PowerShell かターミナルを開きます。管理者として開く必要は、たいていありません。管理者の権限が要るインストーラーは、実行の途中で確認が出ます。

PowerShell・コマンド プロンプトのどちらでも同じ

2

探す:winget search

winget search vscode のように打つと、名前・ID・モニカーなどに文字が含まれるパッケージが並びます。入れるときに使うのは「ID」の列です。

初回はソースの利用条件への同意を聞かれることがある

3

中身を見る:winget show

winget show --id Microsoft.VisualStudioCode -e で、提供元・ライセンス・公式サイト・選ばれるインストーラーを確かめます。提供元が思っていたものと同じかをここで見ます。

知らない ID を入れる前に必ず見る

4

入れる:winget install --id ID -e

ID と -e(--exact)を組み合わせると、1つに確実に絞れます。winget がインストーラーを取得し、ハッシュを確かめてから実行します。

公式が勧める絞り方

5

確かめる: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つで、残りはパッケージを作る人・管理する人向けです。

コマンド 別名 すること 例
searchfindソースからアプリを探すwinget search vscode
showアプリの詳細と選ばれるインストーラーを表示winget show --id Git.Git -e
installaddアプリを入れるwinget install --id Git.Git -e
listls入っているアプリの一覧(winget 以外で入れたものも)winget list
upgradeupdate更新。引数なしなら更新できるアプリの一覧winget upgrade --all
uninstallremove・rmアプリを消すwinget uninstall --id Git.Git -e
export入っているアプリの一覧を JSON に書き出すwinget export -o apps.json
importJSON に書いたアプリをまとめて入れる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構成ファイルのとおりにシステムを整える構成ファイルを指定
dscv3PowerShell DSC v3 のリソース用のコマンドDSC から使う

どのコマンドにも付けられる共通のオプションと、install・upgrade でよく使うオプションをまとめます。

オプション 意味 使う場面
-v・--version単独なら winget の版。install では入れるアプリの版版を指定して入れる
--id・-e(--exact)ID だけで探す・大文字小文字も含めて完全一致1つに絞る
-s・--sourceソースを限る(winget・msstore など)同じ名前が複数のソースにある
--scopeuser(自分だけ)か 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. 1名前で探す → winget search 名前ID の列を写し取る
  2. 2ID で指定する → --id ID頭が同じ別の ID があると、まだ複数になる
  3. 3完全一致にする → --id ID -e大文字小文字まで同じに打つ
  4. 4ソースも決める → --source wingetmsstore と winget の両方に出るとき
  5. 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
ソース名 中身 既定で検索される
wingetWinGet コミュニティ リポジトリ(アプリ)はい
msstoreMicrosoft Store のカタログはい
winget-fontWinGet コミュニティ リポジトリ(フォント)いいえ(--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-versionsexport今の版も書き出す(既定では import は最新を入れる)
-s・--sourceexport特定のソースのアプリだけ書き出す
--ignore-unavailableimport見つからないアプリがあってもエラーにしない
--ignore-versionsimportJSON の版を無視して最新を入れる
--no-upgradeimport入っているアプリは更新しない

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 が認識されないアプリ インストーラーが無い・以前の版・エイリアスがオフ・PATHGet-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 --infoPC の管理者に相談する

管理者権限とスコープ

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-1978335188upgrade --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 StoreChocolatey Community Repositorybucket(既定は main、追加で extras など)
パッケージの形YAML のマニフェストNuGet のパッケージの仕組みを使う公式 README の範囲では書いていない
管理者の権限インストーラーが求めるときだけ確認が出る公式は、ほとんどのソフトは管理者の権限が要るとしているUAC の確認を出さないことを目指すと説明。既定の置き場所はユーザーのフォルダー
一括更新winget upgrade --allchoco 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期連続の黒字決算。

ABOUT RJC RJCがどんな会社か知る 考え方、研修、働き方、福利厚生、社員の前職まで。RJCのことが丸わかり! RJC丸わかりページへ JOB DESCRIPTION 仕事内容・待遇を見てみる 仕事内容、給与・待遇、選考の流れ。経験者も未経験も!応募前に知りたいこと、まとめました! 募集要項を見る ENTRY エントリーする エントリーは1〜2分・履歴書不要です。まずは話を聞いてみたい、という方でも歓迎です! エントリーフォームへ

成長のヒミツ、 ぜんぶ丸わかり