az devops

Note

此參考是 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	管理管理作業。	Extension	GA
az devops admin banner	管理組織橫幅。	Extension	GA
az devops admin banner add	新增橫幅並立即顯示。	Extension	GA
az devops admin banner list	列出橫幅。	Extension	GA
az devops admin banner remove	拿掉橫幅。	Extension	GA
az devops admin banner show	顯示橫幅的詳細數據。	Extension	GA
az devops admin banner update	更新橫幅的訊息、層級或到期日。	Extension	GA
az devops configure	設定 Azure DevOps CLI 或檢視您的設定。	Extension	GA
az devops extension	管理延伸模組。	Extension	GA
az devops extension disable	停用擴充功能。	Extension	GA
az devops extension enable	啟用擴充功能。	Extension	GA
az devops extension install	安裝延伸模組。	Extension	GA
az devops extension list	列出組織中安裝的延伸模組。	Extension	GA
az devops extension search	從市集搜尋延伸模組。	Extension	GA
az devops extension show	取得單一延伸模組的詳細數據。	Extension	GA
az devops extension uninstall	卸載延伸模組。	Extension	GA
az devops invoke	此命令會叫用任何 DevOps 區域和資源的要求。請只使用 json 輸出，因為此命令的回應未修正。實用的檔案 - https://docs.microsoft.com/en-us/rest/api/azure/devops/。	Extension	GA
az devops login	設定要用於特定組織的認證（PAT）。	Extension	GA
az devops logout	清除所有或特定組織的認證。	Extension	GA
az devops project	管理小組專案。	Extension	GA
az devops project create	建立小組專案。	Extension	GA
az devops project delete	刪除小組專案。	Extension	GA
az devops project list	列出小組專案。	Extension	GA
az devops project show	顯示小組專案。	Extension	GA
az devops security	管理安全性相關作業。	Extension	GA
az devops security group	管理安全組。	Extension	GA
az devops security group create	建立新的 Azure DevOps 群組。	Extension	GA
az devops security group delete	刪除 Azure DevOps 群組。	Extension	GA
az devops security group list	列出專案或組織中的所有群組。	Extension	GA
az devops security group membership	管理安全組的成員資格。	Extension	GA
az devops security group membership add	新增成員資格。	Extension	GA
az devops security group membership list	列出群組或用戶的成員資格。	Extension	GA
az devops security group membership remove	拿掉成員資格。	Extension	GA
az devops security group show	顯示群組詳細數據。	Extension	GA
az devops security group update	更新 Azure DevOps 群組的名稱 AND/OR 描述。	Extension	GA
az devops security permission	管理安全性許可權。	Extension	GA
az devops security permission list	列出指定使用者/群組和命名空間的令牌。	Extension	GA
az devops security permission namespace	管理安全性命名空間。	Extension	GA
az devops security permission namespace list	列出組織的所有可用命名空間。	Extension	GA
az devops security permission namespace show	顯示每個命名空間中可用許可權的詳細數據。	Extension	GA
az devops security permission reset	重設指定許可權位的許可權。	Extension	GA
az devops security permission reset-all	清除使用者/群組此令牌的所有許可權。	Extension	GA
az devops security permission show	顯示指定令牌、命名空間和使用者/群組的許可權。	Extension	GA
az devops security permission update	將允許或拒絕許可權指派給指定的使用者/群組。	Extension	GA
az devops service-endpoint	管理服務端點/連線。	Extension	GA
az devops service-endpoint azurerm	管理 Azure RM 服務端點/連線。	Extension	GA
az devops service-endpoint azurerm create	建立 Azure RM 類型服務端點。	Extension	GA
az devops service-endpoint create	使用組態檔建立服務端點。	Extension	GA
az devops service-endpoint delete	刪除服務端點。	Extension	GA
az devops service-endpoint github	管理 GitHub 服務端點/連線。	Extension	GA
az devops service-endpoint github create	建立 GitHub 服務端點。	Extension	GA
az devops service-endpoint list	列出專案中的服務端點。	Extension	GA
az devops service-endpoint show	取得服務端點的詳細數據。	Extension	GA
az devops service-endpoint update	更新服務端點。	Extension	GA
az devops team	管理小組。	Extension	GA
az devops team create	建立團隊。	Extension	GA
az devops team delete	刪除小組。	Extension	GA
az devops team list	列出專案中的所有小組。	Extension	GA
az devops team list-member	列出小組的成員。	Extension	GA
az devops team show	顯示小組詳細數據。	Extension	GA
az devops team update	更新小組的名稱和/或描述。	Extension	GA
az devops user	管理使用者。	Extension	GA
az devops user add	新增使用者。	Extension	GA
az devops user list	列出組織中的使用者 [除了透過 AAD 群組新增的使用者除外]。	Extension	GA
az devops user remove	從組織移除使用者。	Extension	GA
az devops user show	顯示使用者詳細數據。	Extension	GA
az devops user update	更新使用者的授權類型。	Extension	GA
az devops wiki	管理Wiki。	Extension	GA
az devops wiki create	建立Wiki。	Extension	GA
az devops wiki delete	刪除維基。	Extension	GA
az devops wiki list	列出專案或組織中的所有Wiki。	Extension	GA
az devops wiki page	管理Wiki頁面。	Extension	GA
az devops wiki page create	新增頁面。	Extension	GA
az devops wiki page delete	刪除頁面。	Extension	GA
az devops wiki page show	取得頁面的內容或開啟頁面。	Extension	GA
az devops wiki page update	編輯頁面。	Extension	GA
az devops wiki show	顯示Wiki的詳細數據。	Extension	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=my-org-url arg=value'。使用 '' 清除預設值，例如 --defaults project=''' 。

--list -l

列出組態檔的內容。

屬性	值
預設值:	False

--use-git-aliases

設定為 'true' 以設定 Git 別名全域 git 組態檔（若要啟用類似 “git pr list” 的命令）。設定為『false』以移除工具所設定的任何別名。

屬性	值
接受的值:	false, true

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

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 搭配使用。

屬性	值
預設值:	utf-8
接受的值:	ascii, utf-16be, utf-16le, utf-8

--http-method

指定用於要求的方法。

屬性	值
預設值:	GET
接受的值:	DELETE, GET, HEAD, OPTIONS, PATCH, POST, PUT

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

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

設定要用於特定組織的認證（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

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az devops logout

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

az devops logout [--org --organization]

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--org --organization

Azure DevOps 組織 URL。範例： https://dev.azure.com/MyOrganizationName/. 如果未指定任何組織，則會註銷所有組織。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

意見反應

此頁面對您有幫助嗎？

共用方式為

az devops

命令

az devops configure

選擇性參數

az devops invoke

範例

選擇性參數

az devops login

選擇性參數

az devops logout

選擇性參數

意見反應