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=my-org-url 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 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 --organization]
[--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 --organization]
選擇性參數
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 --organization]
選擇性參數
Azure DevOps 組織 URL。 範例: https://dev.azure.com/MyOrganizationName/
. 如果未指定任何組織,則會註銷所有組織。
全域參數
提高日誌詳細程度以顯示所有調試日誌。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID
來設定預設訂用帳戶。
增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。