az devops
注意
此參考是 Azure CLI 的 azure-devops 延伸模組的一部分 (2.30.0 版或更高版本)。 擴充功能會在您第一次執行 az devops 命令時自動安裝。 深入了解擴充功能。
管理 Azure DevOps 組織層級作業。
相關群組 az pipelines:Manage Azure Pipelines az boards: Manage Azure Boards az repos: Manage Azure Repos az artifacts: Manage Azure Artifacts.
命令
az devops configure
設定 Azure DevOps CLI 或檢視您的設定。
az devops configure [--defaults]
[--list]
[--use-git-aliases {false, true}]
選擇性參數
通用引數預設值的空間分隔 'name=value' 組,例如 '--defaults project=my-project-name organization= https://dev.azure.com/organizationName arg=value'。 使用 '' 清除預設值,例如 --defaults project=''' 。
列出組態檔的內容。
設定為 'true' 以設定 Git 別名全域 git 組態檔 (若要啟用類似 「git pr list」 的命令)。 設定為 'false' 以移除工具所設定的任何別名。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az devops feedback
此命令已被取代,並將在未來版本中移除。 請改用 'az feedback'。
顯示如何提供意見反應給 Azure DevOps CLI 小組的資訊。
az devops feedback
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az devops invoke
此命令會叫用任何 DevOps 區域和資源的要求。 請只使用 json 輸出,因為此命令的回應未修正。 有用的檔 - https://docs.microsoft.com/en-us/rest/api/azure/devops/ 。
az devops invoke [--accept-media-type]
[--api-version]
[--area]
[--detect {false, true}]
[--encoding {ascii, utf-16be, utf-16le, utf-8}]
[--http-method {DELETE, GET, HEAD, OPTIONS, PATCH, POST, PUT}]
[--in-file]
[--media-type]
[--org]
[--out-file]
[--query-parameters]
[--resource]
[--route-parameters]
範例
探索與「Wiki」相關的區域
az devops invoke --query "[?contains(area,'wiki')]"
取得專案中的所有 Wiki
az devops invoke --area wiki --resource wikis --route-parameters project={Project Name} -o json
az devops invoke --area wiki --resource wikis --route-parameters project=WikiIssue -o json
將頁面新增至 Wiki
az devops invoke --area wiki --resource pages --route-parameters project={Project Name}
wikiIdentifier={Wiki Id} --in-file {Full File Path containing text to add to wiki}
--query-parameters path={Page Path In Wiki} --http-method PUT --api-version 5.1-preview -o json
az devops invoke --area wiki --resource pages --route-parameters project=WikiIssue
wikiIdentifier=e479f402-2be8-4953-bb0b-3a0209cbc2d2 --in-file D:/temp/createWikiRequestBody.txt
--encoding 'utf-8' --query-parameters path=sample738 --http-method PUT --api-version 5.1-preview -o json
選擇性參數
指定回應的內容類型。
要設定目標的 API 版本。
要尋找資源的區域。
自動偵測組織。
輸入檔的編碼方式。 與 --in-file 搭配使用。
指定用於要求的方法。
包含要求內容之檔案的路徑和檔案名。
指定要求的內容類型。
Azure DevOps 組織 URL。 您可以使用 az devops configure -d organization=ORG_URL 來設定預設組織。 如果未設定為預設,或透過 git 組態挑選,則為必要專案。範例: https://dev.azure.com/MyOrganizationName/ 。
此函式儲存回應本文之檔案的路徑和檔案名。
指定查詢參數的清單。
要運作的資源名稱。
指定路由參數清單。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az devops login
設定要用於特定組織的認證 (PAT)。
如需提供 PAT 作為輸入的詳細資訊,請參閱 https://aka.ms/azure-devops-cli-auth 。
az devops login [--org]
選擇性參數
Azure DevOps 組織 URL。 範例: https://dev.azure.com/MyOrganizationName.
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az devops logout
清除所有或特定組織的認證。
az devops logout [--org]
選擇性參數
Azure DevOps 組織 URL。 範例: https://dev.azure.com/MyOrganizationName/. 如果未指定任何組織,則會登出所有組織。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。