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 選項來接受來源授權合約,並避免出現提示。
相關主題
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應