az devcenter admin catalog
注意
此參考是 Azure CLI 的 devcenter 延伸模組的一部分(2.51.0 版或更高版本)。 擴充功能會在您第一次執行 az devcenter admin catalog 命令時自動安裝。 深入了解擴充功能。
管理目錄。
命令
名稱 | Description | 類型 | 狀態 |
---|---|---|---|
az devcenter admin catalog create |
建立目錄。 |
副檔名 | GA |
az devcenter admin catalog delete |
刪除目錄資源。 |
副檔名 | GA |
az devcenter admin catalog get-sync-error-detail |
取得目錄同步處理錯誤詳細資料。 |
副檔名 | GA |
az devcenter admin catalog list |
列出開發人員中心的目錄。 |
副檔名 | GA |
az devcenter admin catalog show |
取得目錄。 |
副檔名 | GA |
az devcenter admin catalog sync |
同步範本來源的範本。 |
副檔名 | GA |
az devcenter admin catalog update |
更新目錄。 |
副檔名 | GA |
az devcenter admin catalog wait |
將 CLI 置於等候狀態,直到符合條件為止。 |
副檔名 | GA |
az devcenter admin catalog create
建立目錄。
az devcenter admin catalog create --catalog-name
--dev-center
--resource-group
[--ado-git]
[--git-hub]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--sync-type {Manual, Scheduled}]
範例
使用 Azure DevOps 存放庫建立
az devcenter admin catalog create --ado-git path="/templates" branch="main" secret-identifier="https://contosokv.vault.azure.net/secrets/CentralRepoPat" uri="https://contoso@dev.azure.com/contoso/contosoOrg/_git/centralrepo-fakecontoso" --name "CentralCatalog" --dev-center-name "Contoso" --resource-group "rg1"
使用 GitHub 存放庫建立
az devcenter admin catalog create --git-hub path="/templates" branch="main" secret-identifier="https://contosokv.vault.azure.net/secrets/CentralRepoPat" uri="https://github.com/Contoso/centralrepo-fake.git" --name "CentralCatalog" --dev-center-name "Contoso" --resource-group "rg1"
必要參數
目錄的名稱。
開發人員中心的名稱。 使用 az configure -d dev-center=<dev_center_name>
來設定預設值。
資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name>
。
選擇性參數
Azure DevOps 目錄類型的屬性。 支援速記語法、json-file 和 yaml-file。 請嘗試 「??」 以顯示更多。
GitHub 目錄類型的屬性。 支援速記語法、json-file 和 yaml-file。 請嘗試 「??」 以顯示更多。
請勿等候長時間執行的作業完成。
指出針對目錄設定的同步類型。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az devcenter admin catalog delete
刪除目錄資源。
az devcenter admin catalog delete [--catalog-name]
[--dev-center]
[--ids]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
[--yes]
範例
刪除
az devcenter admin catalog delete --name "CentralCatalog" --dev-center-name "Contoso" --resource-group "rg1"
選擇性參數
目錄的名稱。
開發人員中心的名稱。 使用 az configure -d dev-center=<dev_center_name>
來設定預設值。
一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。
請勿等候長時間執行的作業完成。
資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name>
。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
不提示確認。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az devcenter admin catalog get-sync-error-detail
取得目錄同步處理錯誤詳細資料。
az devcenter admin catalog get-sync-error-detail [--catalog-name]
[--dev-center]
[--ids]
[--resource-group]
[--subscription]
範例
取得同步處理錯誤詳細資料
az devcenter admin catalog get-sync-error-detail --name "CentralCatalog" --dev-center-name "Contoso" --resource-group "rg1"
選擇性參數
目錄的名稱。
開發人員中心的名稱。
一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。
資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name>
。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az devcenter admin catalog list
列出開發人員中心的目錄。
az devcenter admin catalog list --dev-center
--resource-group
[--max-items]
[--next-token]
範例
清單
az devcenter admin catalog list --dev-center-name "Contoso" --resource-group "rg1"
必要參數
開發人員中心的名稱。 使用 az configure -d dev-center=<dev_center_name>
來設定預設值。
資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name>
。
選擇性參數
命令輸出中要傳回的專案總數。 如果可用的專案總數超過指定的值,則會在命令的輸出中提供權杖。 若要繼續分頁,請在後續命令的引數中 --next-token
提供權杖值。
標記,指定要開始分頁的位置。 這是先前截斷回應中的權杖值。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az devcenter admin catalog show
取得目錄。
az devcenter admin catalog show [--catalog-name]
[--dev-center]
[--ids]
[--resource-group]
[--subscription]
範例
Get
az devcenter admin catalog show --name "CentralCatalog" --dev-center-name "Contoso" --resource-group "rg1"
選擇性參數
目錄的名稱。
開發人員中心的名稱。 使用 az configure -d dev-center=<dev_center_name>
來設定預設值。
一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。
資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name>
。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az devcenter admin catalog sync
同步範本來源的範本。
az devcenter admin catalog sync [--catalog-name]
[--dev-center]
[--ids]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
範例
Sync
az devcenter admin catalog sync --name "CentralCatalog" --dev-center-name "Contoso" --resource-group "rg1"
選擇性參數
目錄的名稱。
開發人員中心的名稱。 使用 az configure -d dev-center=<dev_center_name>
來設定預設值。
一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。
請勿等候長時間執行的作業完成。
資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name>
。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az devcenter admin catalog update
更新目錄。
az devcenter admin catalog update [--add]
[--ado-git]
[--catalog-name]
[--dev-center]
[--force-string {0, 1, f, false, n, no, t, true, y, yes}]
[--git-hub]
[--ids]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--remove]
[--resource-group]
[--set]
[--subscription]
[--sync-type {Manual, Scheduled}]
範例
更新
az devcenter admin catalog update --git-hub path="/environments" --name "CentralCatalog" --dev-center-name "Contoso" --resource-group "rg1"
選擇性參數
藉由指定路徑和索引鍵值組,將 物件加入物件清單。 範例:--add property.listProperty < key=value、string 或 JSON 字串 > 。
Azure DevOps 目錄類型的屬性。 支援速記語法、json-file 和 yaml-file。 請嘗試 「??」 以顯示更多。
目錄的名稱。
開發人員中心的名稱。 使用 az configure -d dev-center=<dev_center_name>
來設定預設值。
使用 'set' 或 'add' 時,請保留字元串常值,而不是嘗試轉換成 JSON。
GitHub 目錄類型的屬性。 支援速記語法、json-file 和 yaml-file。 請嘗試 「??」 以顯示更多。
一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。
請勿等候長時間執行的作業完成。
從清單中移除屬性或專案。 範例:--remove property.list OR --remove 屬性ToRemove。
資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name>
。
指定要設定的屬性路徑和值,以更新物件。 範例:--set property1.property2=。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
指出針對目錄設定的同步類型。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az devcenter admin catalog wait
將 CLI 置於等候狀態,直到符合條件為止。
az devcenter admin catalog wait [--catalog-name]
[--created]
[--custom]
[--deleted]
[--dev-center]
[--exists]
[--ids]
[--interval]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
選擇性參數
目錄的名稱。
請等候在 'Succeeded' 使用 'provisioningState' 建立。
等到條件符合自定義 JMESPath 查詢為止。 例如 provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running']。
等到刪除為止。
開發人員中心的名稱。 使用 az configure -d dev-center=<dev_center_name>
來設定預設值。
等候資源存在。
一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。
輪詢間隔以秒為單位。
資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name>
。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
以秒為單位的等候上限。
等到 provisioningState 更新為 'Succeeded'。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應