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.

命令

名稱 Description 類型 狀態
az devops admin

管理管理作業。

擴充 GA
az devops admin banner

管理組織橫幅。

擴充 GA
az devops admin banner add

新增橫幅並立即顯示。

擴充 GA
az devops admin banner list

列出橫幅。

擴充 GA
az devops admin banner remove

移除橫幅。

擴充 GA
az devops admin banner show

顯示橫幅的詳細資料。

擴充 GA
az devops admin banner update

更新橫幅的訊息、層級或到期日。

擴充 GA
az devops configure

設定 Azure DevOps CLI 或檢視您的設定。

擴充 GA
az devops extension

管理延伸模組。

擴充 GA
az devops extension disable

停用擴充功能。

擴充 GA
az devops extension enable

啟用擴充功能。

擴充 GA
az devops extension install

安裝延伸模組。

擴充 GA
az devops extension list

列出組織中安裝的延伸模組。

擴充 GA
az devops extension search

從市集搜尋延伸模組。

擴充 GA
az devops extension show

取得單一延伸模組的詳細資料。

擴充 GA
az devops extension uninstall

卸載延伸模組。

擴充 GA
az devops feedback

顯示如何提供意見反應給 Azure DevOps CLI 小組的資訊。

擴充 已取代
az devops invoke

此命令會叫用任何 DevOps 區域和資源的要求。 請只使用 json 輸出,因為此命令的回應未修正。 有用的檔 - https://docs.microsoft.com/en-us/rest/api/azure/devops/

擴充 GA
az devops login

設定要用於特定組織的認證 (PAT)。

擴充 GA
az devops logout

清除所有或特定組織的認證。

擴充 GA
az devops project

管理小組專案。

擴充 GA
az devops project create

建立小組專案。

擴充 GA
az devops project delete

刪除小組專案。

擴充 GA
az devops project list

列出小組專案。

擴充 GA
az devops project show

顯示小組專案。

擴充 GA
az devops security

管理安全性相關作業。

擴充 GA
az devops security group

管理安全性群組。

擴充 GA
az devops security group create

建立新的 Azure DevOps 群組。

擴充 GA
az devops security group delete

刪除 Azure DevOps 群組。

擴充 GA
az devops security group list

列出專案或組織中的所有群組。

擴充 GA
az devops security group membership

管理安全性群組的成員資格。

擴充 GA
az devops security group membership add

新增成員資格。

擴充 GA
az devops security group membership list

列出群組或使用者的成員資格。

擴充 GA
az devops security group membership remove

移除成員資格。

擴充 GA
az devops security group show

顯示群組詳細資料。

擴充 GA
az devops security group update

更新 Azure DevOps 群組的名稱 AND/OR 描述。

擴充 GA
az devops security permission

管理安全性許可權。

擴充 GA
az devops security permission list

列出指定使用者/群組和命名空間的權杖。

擴充 GA
az devops security permission namespace

管理安全性命名空間。

擴充 GA
az devops security permission namespace list

列出組織的所有可用命名空間。

擴充 GA
az devops security permission namespace show

顯示每個命名空間中可用許可權的詳細資料。

擴充 GA
az devops security permission reset

重設指定許可權位的許可權。

擴充 GA
az devops security permission reset-all

清除使用者/群組此權杖的擁有權限。

擴充 GA
az devops security permission show

顯示指定權杖、命名空間和使用者/群組的許可權。

擴充 GA
az devops security permission update

將允許或拒絕許可權指派給指定的使用者/群組。

擴充 GA
az devops service-endpoint

管理服務端點/連線。

擴充 GA
az devops service-endpoint azurerm

管理 Azure RM 服務端點/連線。

擴充 GA
az devops service-endpoint azurerm create

建立 Azure RM 類型服務端點。

擴充 GA
az devops service-endpoint create

使用組態檔建立服務端點。

擴充 GA
az devops service-endpoint delete

刪除服務端點。

擴充 GA
az devops service-endpoint github

管理 GitHub 服務端點/連線。

擴充 GA
az devops service-endpoint github create

建立 GitHub 服務端點。

擴充 GA
az devops service-endpoint list

列出專案中的服務端點。

擴充 GA
az devops service-endpoint show

取得服務端點的詳細資料。

擴充 GA
az devops service-endpoint update

更新服務端點。

擴充 GA
az devops team

管理小組。

擴充 GA
az devops team create

建立團隊。

擴充 GA
az devops team delete

刪除小組。

擴充 GA
az devops team list

列出專案中的所有小組。

擴充 GA
az devops team list-member

列出小組的成員。

擴充 GA
az devops team show

顯示小組詳細資料。

擴充 GA
az devops team update

更新小組的名稱和/或描述。

擴充 GA
az devops user

管理使用者。

擴充 GA
az devops user add

新增使用者。

擴充 GA
az devops user list

列出組織中的使用者 [除了透過 AAD 群組新增的使用者除外]。

擴充 GA
az devops user remove

從組織移除使用者。

擴充 GA
az devops user show

顯示使用者詳細資料。

擴充 GA
az devops user update

更新使用者的授權類型。

擴充 GA
az devops wiki

管理 Wiki。

擴充 GA
az devops wiki create

建立 Wiki。

擴充 GA
az devops wiki delete

刪除 Wiki。

擴充 GA
az devops wiki list

列出專案或組織中的所有 Wiki。

擴充 GA
az devops wiki page

管理 Wiki 頁面。

擴充 GA
az devops wiki page create

新增頁面。

擴充 GA
az devops wiki page delete

刪除頁面。

擴充 GA
az devops wiki page show

取得頁面的內容或開啟頁面。

擴充 GA
az devops wiki page update

編輯 頁面。

擴充 GA
az devops wiki show

顯示 Wiki 的詳細資料。

擴充 GA

az devops configure

設定 Azure DevOps CLI 或檢視您的設定。

az devops configure [--defaults]
                    [--list]
                    [--use-git-aliases {false, true}]

選擇性參數

--defaults -d

通用引數預設值的空間分隔 'name=value' 組,例如 '--defaults project=my-project-name organization= https://dev.azure.com/organizationName arg=value'。 使用 '' 清除預設值,例如 --defaults project=''' 。

--list -l

列出組態檔的內容。

預設值: False
--use-git-aliases

設定為 'true' 以設定 Git 別名全域 git 組態檔 (若要啟用類似 「git pr list」 的命令)。 設定為 'false' 以移除工具所設定的任何別名。

接受的值: false, true
全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az devops feedback

已被取代

此命令已被取代,並將在未來版本中移除。 請改用 'az feedback'。

顯示如何提供意見反應給 Azure DevOps CLI 小組的資訊。

az devops feedback
全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --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

選擇性參數

--accept-media-type

指定回應的內容類型。

預設值: application/json
--api-version

要設定目標的 API 版本。

預設值: 5.0
--area

要尋找資源的區域。

--detect

自動偵測組織。

接受的值: false, true
--encoding

輸入檔的編碼方式。 與 --in-file 搭配使用。

接受的值: ascii, utf-16be, utf-16le, utf-8
預設值: utf-8
--http-method

指定用於要求的方法。

接受的值: DELETE, GET, HEAD, OPTIONS, PATCH, POST, PUT
預設值: GET
--in-file

包含要求內容之檔案的路徑和檔案名。

--media-type

指定要求的內容類型。

預設值: application/json
--org --organization

Azure DevOps 組織 URL。 您可以使用 az devops configure -d organization=ORG_URL 來設定預設組織。 如果未設定為預設,或透過 git 組態挑選,則為必要專案。範例: https://dev.azure.com/MyOrganizationName/

--out-file

此函式儲存回應本文之檔案的路徑和檔案名。

--query-parameters

指定查詢參數的清單。

--resource

要運作的資源名稱。

--route-parameters

指定路由參數清單。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az devops login

設定要用於特定組織的認證 (PAT)。

如需提供 PAT 作為輸入的詳細資訊,請參閱 https://aka.ms/azure-devops-cli-auth

az devops login [--org]

選擇性參數

--org --organization

Azure DevOps 組織 URL。 範例: https://dev.azure.com/MyOrganizationName.

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az devops logout

清除所有或特定組織的認證。

az devops logout [--org]

選擇性參數

--org --organization

Azure DevOps 組織 URL。 範例: https://dev.azure.com/MyOrganizationName/. 如果未指定任何組織,則會登出所有組織。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。