共用方式為


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

管理管理作業。

擴充套件 加語
az devops admin banner

管理組織橫幅。

擴充套件 加語
az devops admin banner add

新增橫幅並立即顯示。

擴充套件 加語
az devops admin banner list

列出橫幅。

擴充套件 加語
az devops admin banner remove

拿掉橫幅。

擴充套件 加語
az devops admin banner show

顯示橫幅的詳細數據。

擴充套件 加語
az devops admin banner update

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

擴充套件 加語
az devops configure

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

擴充套件 加語
az devops extension

管理延伸模組。

擴充套件 加語
az devops extension disable

停用擴充功能。

擴充套件 加語
az devops extension enable

啟用擴充功能。

擴充套件 加語
az devops extension install

安裝延伸模組。

擴充套件 加語
az devops extension list

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

擴充套件 加語
az devops extension search

從市集搜尋延伸模組。

擴充套件 加語
az devops extension show

取得單一延伸模組的詳細數據。

擴充套件 加語
az devops extension uninstall

卸載延伸模組。

擴充套件 加語
az devops invoke

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

擴充套件 加語
az devops login

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

擴充套件 加語
az devops logout

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

擴充套件 加語
az devops project

管理小組專案。

擴充套件 加語
az devops project create

建立小組專案。

擴充套件 加語
az devops project delete

刪除小組專案。

擴充套件 加語
az devops project list

列出小組專案。

擴充套件 加語
az devops project show

顯示小組專案。

擴充套件 加語
az devops security

管理安全性相關作業。

擴充套件 加語
az devops security group

管理安全組。

擴充套件 加語
az devops security group create

建立新的 Azure DevOps 群組。

擴充套件 加語
az devops security group delete

刪除 Azure DevOps 群組。

擴充套件 加語
az devops security group list

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

擴充套件 加語
az devops security group membership

管理安全組的成員資格。

擴充套件 加語
az devops security group membership add

新增成員資格。

擴充套件 加語
az devops security group membership list

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

擴充套件 加語
az devops security group membership remove

拿掉成員資格。

擴充套件 加語
az devops security group show

顯示群組詳細數據。

擴充套件 加語
az devops security group update

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

擴充套件 加語
az devops security permission

管理安全性許可權。

擴充套件 加語
az devops security permission list

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

擴充套件 加語
az devops security permission namespace

管理安全性命名空間。

擴充套件 加語
az devops security permission namespace list

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

擴充套件 加語
az devops security permission namespace show

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

擴充套件 加語
az devops security permission reset

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

擴充套件 加語
az devops security permission reset-all

清除使用者/群組此令牌的所有許可權。

擴充套件 加語
az devops security permission show

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

擴充套件 加語
az devops security permission update

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

擴充套件 加語
az devops service-endpoint

管理服務端點/連線。

擴充套件 加語
az devops service-endpoint azurerm

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

擴充套件 加語
az devops service-endpoint azurerm create

建立 Azure RM 類型服務端點。

擴充套件 加語
az devops service-endpoint create

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

擴充套件 加語
az devops service-endpoint delete

刪除服務端點。

擴充套件 加語
az devops service-endpoint github

管理 GitHub 服務端點/連線。

擴充套件 加語
az devops service-endpoint github create

建立 GitHub 服務端點。

擴充套件 加語
az devops service-endpoint list

列出專案中的服務端點。

擴充套件 加語
az devops service-endpoint show

取得服務端點的詳細數據。

擴充套件 加語
az devops service-endpoint update

更新服務端點。

擴充套件 加語
az devops team

管理小組。

擴充套件 加語
az devops team create

建立團隊。

擴充套件 加語
az devops team delete

刪除小組。

擴充套件 加語
az devops team list

列出專案中的所有小組。

擴充套件 加語
az devops team list-member

列出小組的成員。

擴充套件 加語
az devops team show

顯示小組詳細數據。

擴充套件 加語
az devops team update

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

擴充套件 加語
az devops user

管理使用者。

擴充套件 加語
az devops user add

新增使用者。

擴充套件 加語
az devops user list

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

擴充套件 加語
az devops user remove

從組織移除使用者。

擴充套件 加語
az devops user show

顯示使用者詳細數據。

擴充套件 加語
az devops user update

更新使用者的授權類型。

擴充套件 加語
az devops wiki

管理Wiki。

擴充套件 加語
az devops wiki create

建立Wiki。

擴充套件 加語
az devops wiki delete

刪除維基。

擴充套件 加語
az devops wiki list

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

擴充套件 加語
az devops wiki page

管理Wiki頁面。

擴充套件 加語
az devops wiki page create

新增頁面。

擴充套件 加語
az devops wiki page delete

刪除頁面。

擴充套件 加語
az devops wiki page show

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

擴充套件 加語
az devops wiki page update

編輯頁面。

擴充套件 加語
az devops wiki show

顯示Wiki的詳細數據。

擴充套件 加語

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=my-org-url 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 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

選擇性參數

--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 --organization]

選擇性參數

--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 --organization]

選擇性參數

--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。