winget source コマンド

winget ツールの source コマンドを使用すると、Windows パッケージ マネージャーのソースを管理できます。 source コマンドを使用すると、リポジトリの追加、一覧表示、更新、削除、リセット、またはエクスポートを実行できます。

ソース リポジトリは、アプリケーションを検出してインストールするためのデータを提供します。 セキュリティで保護された信頼できるソースの場所のみを使用してください。

Windows パッケージ マネージャーでは、次の 2 つの既定のリポジトリが指定されます。これらは、winget source list を使用して一覧表示できます。

• msstore - Microsoft Store カタログ。
• winget - Windows パッケージ マネージャー アプリ リポジトリ。

使用

winget source <subcommand> <options>

引数

次の引数を使用できます。

引数	説明
-?、--help	このコマンドに関する追加のヘルプを取得します。

次の図は、source コマンドのヘルプを示しています。

Options

次のオプションを使用できます。

オプション	説明
-?,--help	選択したコマンドに関するヘルプを表示します。
--wait	終了する前に任意のキーを押すようユーザーに求めます。
--logs,--open-logs	既定のログの場所を開きます。
--verbose, --verbose-logs	ログ記録設定をオーバーライドし、詳細ログを作成します。
--disable-interactivity	対話型プロンプトを無効にします。

サブコマンド

source コマンドは、次のサブコマンドをサポートしています。

サブコマンド	説明
add	新しいソースを追加します。
list	有効なソースの一覧を列挙します。
update	ソースを更新します。
remove	ソースを削除します。
reset	winget と msstore を初期構成にリセットします。
export	現在のソースをエクスポートします。

add

add サブコマンドは、新しいソースを追加します。 このサブコマンドには、--name と --arg のオプションが必要です。 このコマンドによってユーザー アクセスが変更されるため、add を使用するには、管理者特権が必要です。

使用法:

winget source add [-n, --name] <name> [-a, --arg] <url> [[-t, --type] <type>]

引数

次の引数を使用できます。

引数	説明
-n, --name	ソースを識別するための名前。
-a, --arg	ソースの URL または UNC。
-t、--type	ソース の種類。

Options

次のオプションを使用できます。

オプション	説明
--header	省略可能な Windows-Package-Manager REST ソースの HTTP ヘッダー。
--accept-source-agreements	ソースの使用許諾契約に同意し、プロンプトを回避するために使用されます。
-?、--help	このコマンドに関する追加のヘルプを取得します。
--wait	終了する前に任意のキーを押すようユーザーに求めます。
--logs,--open-logs	既定のログの場所を開きます。
--verbose, --verbose-logs	ログ記録設定をオーバーライドし、詳細ログを作成します。
--disable-interactivity	対話型プロンプトを無効にします。

たとえば、winget source add --name Contoso https://www.contoso.com/cache は、CONTOSO リポジトリを URL https://www.contoso.com/cache に追加します。

省略可能な type パラメーター

add サブコマンドでは、省略可能な type パラメーターがサポートされています。これは、接続先のリポジトリーの種類をクライアントに伝えます。 次の種類がサポートされています。

Type	説明
Microsoft.PreIndexed.Package	既定のソースの種類です。

list

list サブコマンドは、現在有効になっているソースを列挙するか、特定のソースの詳細を提供します。

使用法:

winget source list [[-n, --name] <name>]

Aliases

このサブコマンドでは、次のエイリアスを使用できます。

• ls

引数

次の引数を使用できます。

引数	説明
-n, --name	ソースを識別するための名前。

Options

次のオプションを使用できます。

オプション	説明
-?、--help	このコマンドに関する追加のヘルプを取得します。
--wait	終了する前に任意のキーを押すようユーザーに求めます。
--logs,--open-logs	既定のログの場所を開きます。
--verbose, --verbose-logs	ログ記録設定をオーバーライドし、詳細ログを作成します。
--disable-interactivity	対話型プロンプトを無効にします。

list all

list サブコマンド単独の場合 (winget source list)、サポートされているソースの完全一覧が提供されます。

Name   Arg
-----------------------------------------
winget https://winget.azureedge.net/cache

list source details

ソースに関する完全な詳細を取得するには、ソースの名前を渡します。 次に例を示します。

winget source list --name Contoso

次の出力が返されます。

Name   : Contoso
Type   : Microsoft.PreIndexed.Package
Arg    : https://pkgmgr-int.azureedge.net/cache
Data   : AppInstallerSQLiteIndex-int_g4ype1skzj3jy
Updated: 2020-4-14 17:45:32.000

• Name はソースの名前です。
• Type は、リポジトリの種類です。
• Arg は、ソースが使用する URL またはパスです。
• Data は、省略可能なパッケージ名です (該当する場合)。
• Updated は、ソースが最後に更新された日時です。

update

update サブ コマンドは、個々のソースまたはすべてに対して更新を強制します。

使用法:

winget source update [[-n, --name] <name>]

Aliases

このサブコマンドでは、次のエイリアスを使用できます。

• 最新の情報に更新

引数

次の引数を使用できます。

引数	説明
-n, --name	ソースを識別するための名前。

Options

次のオプションを使用できます。

オプション	説明
-?、--help	このコマンドに関する追加のヘルプを取得します。
--wait	終了する前に任意のキーを押すようユーザーに求めます。
--logs,--open-logs	既定のログの場所を開きます。
--verbose, --verbose-logs	ログ記録設定をオーバーライドし、詳細ログを作成します。
--disable-interactivity	対話型プロンプトを無効にします。

update all

update サブコマンド単独の場合 (winget source update)、すべてのリポジトリに対する更新を要求します。

更新ソース

--name オプションを指定した update サブコマンドは、名前を指定されたソースに更新を指示します。 たとえば、winget source update --name Contoso により、Contoso リポジトリへの更新が強制されます。

remove

remove サブコマンドは、ソースを削除します。 このサブコマンドでは、ソースを識別するために、--name オプションが必要です。 このコマンドによってユーザー アクセスが変更されるため、remove を使用するには、管理者特権が必要です。

使用法:

winget source remove [-n, --name] <name>

Aliases

このサブコマンドでは、次のエイリアスを使用できます。

• rm

引数

次の引数を使用できます。

引数	説明
-n, --name	ソースを識別するための名前。

Options

次のオプションを使用できます。

オプション	説明
-?、--help	このコマンドに関する追加のヘルプを取得します。
--wait	終了する前に任意のキーを押すようユーザーに求めます。
--logs,--open-logs	既定のログの場所を開きます。
--verbose, --verbose-logs	ログ記録設定をオーバーライドし、詳細ログを作成します。
--disable-interactivity	対話型プロンプトを無効にします。

例

winget source remove --name Contoso

このコマンドを実行すると、Contoso リポジトリが削除されます。

reset

reset サブコマンドは、クライアントを元の構成にリセットし、デフォルトを除くすべてのソースを削除します。 このサブコマンドは稀なケースでのみ使用してください。 このコマンドによってユーザー アクセスが変更されるため、reset を使用するには、管理者特権が必要です。

reset コマンドによってすべてのソースが削除されるため、--force オプションを使用してアクションを強制する必要があります。

使用法:

winget source reset --force

引数

次の引数を使用できます。

引数	説明
-n, --name	ソースを識別するための名前。

Options

次のオプションを使用できます。

オプション	説明
-?、--help	このコマンドに関する追加のヘルプを取得します。
--wait	終了する前に任意のキーを押すようユーザーに求めます。
--logs,--open-logs	既定のログの場所を開きます。
--verbose, --verbose-logs	ログ記録設定をオーバーライドし、詳細ログを作成します。
--disable-interactivity	対話型プロンプトを無効にします。

エクスポート

export サブコマンドは、ソースの特定の詳細を JSON 出力にエクスポートしま。

引数

次の引数を使用できます。

引数	説明
-n, --name	ソースを識別するための名前。

Options

次のオプションを使用できます。

オプション	説明
-?、--help	このコマンドに関する追加のヘルプを取得します。
--wait	終了する前に任意のキーを押すようユーザーに求めます。
--logs,--open-logs	既定のログの場所を開きます。
--verbose, --verbose-logs	ログ記録設定をオーバーライドし、詳細ログを作成します。
--disable-interactivity	対話型プロンプトを無効にします。

例

winget source export winget

次の出力が返されます。

{"Arg":"https://winget.azureedge.net/cache","Data":"Microsoft.Winget.Source_8wekyb3d8bbwe","Identifier":"Microsoft.Winget.Source_8wekyb3d8bbwe","Name":"winget","Type":"Microsoft.PreIndexed.Package"}

ソースの契約

個々のソースでは、リポジトリを追加または使用する前に、提示された条件にユーザーが同意することが要求される場合があります。 ユーザーが契約に同意しない場合、ユーザーはソースにアクセスできません。

--accept-source-agreements オプションを使用して、ソースのライセンス契約に同意し、プロンプトを回避できます。

関連トピック

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