winget source 命令

winget 工具 source 命令可讓您管理「Windows 封裝管理員」的來源。 使用 source 命令，您可以新增、列出、更新、移除、重設或匯出存放庫。

來源存放庫可為您提供探索及安裝應用程式的資料。 僅使用安全且受信任的來源位置。

「Windows 封裝管理員」指定下列兩個預設存放庫，您可以使用 winget source list 來列出它們。

• msstore - Microsoft Store 目錄。
• winget - 「Windows 封裝管理員」應用程式存放庫。

使用方式

winget source <subcommand> <options>

引數

下列是可用的引數。

引數	描述
-?, --help	取得此命令的其他說明。

下列影像顯示 [來源] 命令的說明：

選項。

可用選項如下。

選項	描述
-?,--help	顯示所選命令的說明。
--wait	提示使用者在結束之前按任何鍵。
--logs,--open-logs	開啟預設記錄位置。
--verbose, --verbose-logs	用於覆寫記錄設定，並建立詳細資訊記錄。
--nowarn,--ignore-warnings	隱藏警告輸出。
--disable-interactivity	停用互動式提示。
--proxy	設定此執行所要使用的 Proxy。
--no-proxy	停用此執行的 Proxy。

子命令

source 命令支援下列子命令。

子命令	描述
add	新增來源。
清單	列舉已啟用的來源清單。
update	更新來源。
remove	移除來源。
reset	將 winget 和 msstore 重設回初始設定。
export	匯出目前的來源。

add

add 子命令可新增新的來源。 此子命令需要 --name 和 --arg 選項。 因為該命令會變更使用者的存取權，所以使用 add 需要系統管理員權限。

Usage :

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

引數

下列是可用的引數。

引數	描述
-n, --name	要用來識別來源的名稱。
-a, --arg	來源的 URL 或 UNC。
-t, --type	來源的類型。

選項。

可用選項如下。

選項	描述
--trust-level	來源的信任層級 (無或受信任)。
--header	選用性的 Windows-Package-Manager REST 來源 HTTP 標頭。
--accept-source-agreements	用於接受來源授權合約且避免提示。
--explicit
-?, --help	取得此命令的其他說明。
--wait	提示使用者在結束之前按任何鍵。
--logs,--open-logs	開啟預設記錄位置。
--verbose, --verbose-logs	用於覆寫記錄設定，並建立詳細資訊記錄。
--nowarn,--ignore-warnings	隱藏警告輸出。
--disable-interactivity	停用互動式提示。
--proxy	設定此執行所要使用的 Proxy。
--no-proxy	停用此執行的 Proxy。

例如，winget source add --name Contoso https://www.contoso.com/cache 會在 URL https://www.contoso.com/cache 新增 Contoso 存放庫。

選用性的 type 參數

add 子命令支援選用性的類型參數，該參數會告訴用戶端它正在連接到什麼類型的存放庫。 支援下列的類型。

類型	描述
Microsoft.PreIndexed.Package	預設的來源類型。

清單

list 子命令可列舉目前啟用的來源，或提供特定來源的詳細資料。

Usage :

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

別名

此子命令可使用下列別名：

• ls

引數

下列是可用的引數。

引數	描述
-n, --name	要用來識別來源的名稱。

選項。

可用選項如下。

選項	描述
-?, --help	取得此命令的其他說明。
--wait	提示使用者在結束之前按任何鍵。
--logs,--open-logs	開啟預設記錄位置。
--verbose, --verbose-logs	用於覆寫記錄設定，並建立詳細資訊記錄。
--nowarn,--ignore-warnings	隱藏警告輸出。
--disable-interactivity	停用互動式提示。
--proxy	設定此執行所要使用的 Proxy。
--no-proxy	停用此執行的 Proxy。

全部列出

list 子命令本身 (winget source list) 提供了所支援的完整來源清單：

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

列出來源詳細資料

若要取得有關來源的完整詳細資料，請傳入來源的名稱。 例如：

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 子命令會強制更新個別來源或所有來源。

Usage :

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

別名

此子命令可使用下列別名：

• 重新整理

引數

下列是可用的引數。

引數	描述
-n, --name	要用來識別來源的名稱。

選項。

可用選項如下。

選項	描述
-?, --help	取得此命令的其他說明。
--wait	提示使用者在結束之前按任何鍵。
--logs,--open-logs	開啟預設記錄位置。
--verbose, --verbose-logs	用於覆寫記錄設定，並建立詳細資訊記錄。
--nowarn,--ignore-warnings	隱藏警告輸出。
--disable-interactivity	停用互動式提示。
--proxy	設定此執行所要使用的 Proxy。
--no-proxy	停用此執行的 Proxy。

更新全部

update 子命令本身 (winget source update) 會要求更新所有存放庫。

更新來源

含 --name 選項的 [更新] 子命令會將更新導向至具名來源。 例如：winget source update --name Contoso 會強制更新 Contoso 存放庫。

remove

remove 子命令會移除來源。 此子命令需要 --name 選項來識別來源。 因為該命令會變更使用者的存取權，所以使用 remove 需要系統管理員權限。

Usage :

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

別名

此子命令可使用下列別名：

• rm

引數

下列是可用的引數。

引數	描述
-n, --name	要用來識別來源的名稱。

選項。

可用選項如下。

選項	描述
-?, --help	取得此命令的其他說明。
--wait	提示使用者在結束之前按任何鍵。
--logs,--open-logs	開啟預設記錄位置。
--verbose, --verbose-logs	用於覆寫記錄設定，並建立詳細資訊記錄。
--nowarn,--ignore-warnings	隱藏警告輸出。
--disable-interactivity	停用互動式提示。
--proxy	設定此執行所要使用的 Proxy。
--no-proxy	停用此執行的 Proxy。

範例

winget source remove --name Contoso

此命令會移除 Contoso 存放庫。

reset

reset 子命令會將用戶端重設回到其原始組態，並移除預設值以外的所有來源。 僅在極少數的情況下才會使用此子命令。 因為該命令會變更使用者的存取權，所以使用 reset 需要系統管理員權限。

因為 reset 命令會移除所有來源，所以您必須使用 --force 選項來強制執行該動作。

Usage :

winget source reset [[-n] <name>] [<options>]

引數

下列是可用的引數。

引數	描述
-n, --name	要用來識別來源的名稱。

選項。

可用選項如下。

選項	描述
--force	強制重設來源。
-?, --help	取得此命令的其他說明。
--wait	提示使用者在結束之前按任何鍵。
--logs,--open-logs	開啟預設記錄位置。
--verbose, --verbose-logs	用於覆寫記錄設定，並建立詳細資訊記錄。
--nowarn,--ignore-warnings	隱藏警告輸出。
--disable-interactivity	停用互動式提示。
--proxy	設定此執行所要使用的 Proxy。
--no-proxy	停用此執行的 Proxy。

匯出

export 子命令會將來源的特定詳細資料匯出成 JSON 輸出。

Usage :

winget source export [[-n] <name>] [<options>]

引數

下列是可用的引數。

引數	描述
-n, --name	要用來識別來源的名稱。

選項。

可用選項如下。

選項	描述
-?, --help	取得此命令的其他說明。
--wait	提示使用者在結束之前按任何鍵。
--logs,--open-logs	開啟預設記錄位置。
--verbose, --verbose-logs	用於覆寫記錄設定，並建立詳細資訊記錄。
--nowarn,--ignore-warnings	隱藏警告輸出。
--disable-interactivity	停用互動式提示。
--proxy	設定此執行所要使用的 Proxy。
--no-proxy	停用此執行的 Proxy。

範例

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 工具來安裝和管理應用程式