az repos

注意

此參考是 Azure CLI 的 azure-devops 延伸模組的一部分 （2.30.0 版或更高版本）。 擴充功能會在您第一次執行 az repos 命令時自動安裝。 深入了解擴充功能。

管理 Azure Repos。

此命令群組是 azure-devops 擴充功能的一部分。

命令

名稱	Description	類型	狀態
az repos create	在小組專案中建立 Git 存放庫。	擴充	GA
az repos delete	刪除 Team 專案中的 Git 存放庫。	擴充	GA
az repos import	管理 Git 存放庫匯入。	擴充	GA
az repos import create	建立 Git 匯入要求。	擴充	GA
az repos list	列出小組專案的 Git 存放庫。	擴充	GA
az repos policy	管理分支原則。	擴充	GA
az repos policy approver-count	管理核准者計數原則。	擴充	GA
az repos policy approver-count create	建立核准者計數原則。	擴充	GA
az repos policy approver-count update	更新核准者計數原則。	擴充	GA
az repos policy build	管理建置原則。	擴充	GA
az repos policy build create	建立建置原則。	擴充	GA
az repos policy build update	更新組建原則。	擴充	GA
az repos policy case-enforcement	管理案例強制執行原則。	擴充	GA
az repos policy case-enforcement create	建立案例強制執行原則。	擴充	GA
az repos policy case-enforcement update	更新案例強制執行原則。	擴充	GA
az repos policy comment-required	管理批註所需的原則。	擴充	GA
az repos policy comment-required create	建立批註解析所需的原則。	擴充	GA
az repos policy comment-required update	更新批註解決所需的原則。	擴充	GA
az repos policy create	使用組態檔建立原則。	擴充	GA
az repos policy delete	刪除原則。	擴充	GA
az repos policy file-size	管理檔案大小原則。	擴充	GA
az repos policy file-size create	建立檔案大小原則。	擴充	GA
az repos policy file-size update	更新檔案大小原則。	擴充	GA
az repos policy list	列出專案中的所有原則。	擴充	GA
az repos policy merge-strategy	管理合併策略原則。	擴充	GA
az repos policy merge-strategy create	建立合併策略原則。	擴充	GA
az repos policy merge-strategy update	更新合併策略原則。	擴充	GA
az repos policy required-reviewer	管理必要的檢閱者原則。	擴充	GA
az repos policy required-reviewer create	建立必要的檢閱者原則。	擴充	GA
az repos policy required-reviewer update	更新必要的檢閱者原則。	擴充	GA
az repos policy show	顯示原則詳細資料。	擴充	GA
az repos policy update	使用組態檔更新原則。	擴充	GA
az repos policy work-item-linking	管理工作專案連結原則。	擴充	GA
az repos policy work-item-linking create	建立工作專案連結原則。	擴充	GA
az repos policy work-item-linking update	更新工作專案連結原則。	擴充	GA
az repos pr	管理提取要求。	擴充	GA
az repos pr checkout	如果沒有任何本機變更，請在本機簽出 PR 來源分支。	擴充	GA
az repos pr create	建立提取要求。	擴充	GA
az repos pr list	列出提取要求。	擴充	GA
az repos pr policy	管理提取要求原則。	擴充	GA
az repos pr policy list	列出提取要求的原則。	擴充	GA
az repos pr policy queue	將提取要求的原則評估排入佇列。	擴充	GA
az repos pr reviewer	管理提取要求檢閱者。	擴充	GA
az repos pr reviewer add	將一或多個檢閱者新增至提取要求。	擴充	GA
az repos pr reviewer list	列出提取要求的檢閱者。	擴充	GA
az repos pr reviewer remove	從提取要求中移除一或多個檢閱者。	擴充	GA
az repos pr set-vote	對提取要求進行投票。	擴充	GA
az repos pr show	取得提取要求的詳細資料。	擴充	GA
az repos pr update	更新提取要求。	擴充	GA
az repos pr work-item	管理與提取要求相關聯的工作專案。	擴充	GA
az repos pr work-item add	將一或多個工作專案連結至提取要求。	擴充	GA
az repos pr work-item list	列出提取要求的連結工作專案。	擴充	GA
az repos pr work-item remove	從提取要求取消連結一或多個工作專案。	擴充	GA
az repos ref	管理 Git 參考。	擴充	GA
az repos ref create	建立參考。	擴充	GA
az repos ref delete	刪除參考。	擴充	GA
az repos ref list	列出參考。	擴充	GA
az repos ref lock	鎖定參考。	擴充	GA
az repos ref unlock	解除鎖定參考。	擴充	GA
az repos show	取得 Git 存放庫的詳細資料。	擴充	GA
az repos update	更新 Git 存放庫。	擴充	GA

az repos create

在小組專案中建立 Git 存放庫。

az repos create --name
                [--detect {false, true}]
                [--open]
                [--org]
                [--project]

必要參數

--name

新存放庫的名稱。

選擇性參數

--detect

自動偵測組織。

接受的值: false, true

--open

在網頁瀏覽器中開啟存放庫頁面。

預設值: False

--org --organization

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

--project -p

專案的名稱或識別碼。 您可以使用 az devops configure -d project=NAME_OR_ID 來設定預設專案。 如果未設定為預設，或透過 git 組態挑選，則為必要專案。

全域參數

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

刪除 Team 專案中的 Git 存放庫。

az repos delete --id
                [--detect {false, true}]
                [--org]
                [--project]
                [--yes]

必要參數

--id

存放庫的識別碼。

選擇性參數

--detect

自動偵測組織。

接受的值: false, true

--org --organization

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

--project -p

專案的名稱或識別碼。 您可以使用 az devops configure -d project=NAME_OR_ID 來設定預設專案。 如果未設定為預設，或透過 git 組態挑選，則為必要專案。

--yes -y

不提示確認。

預設值: False

全域參數

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

列出小組專案的 Git 存放庫。

az repos list [--detect {false, true}]
              [--org]
              [--project]

選擇性參數

--detect

自動偵測組織。

接受的值: false, true

--org --organization

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

--project -p

專案的名稱或識別碼。 您可以使用 az devops configure -d project=NAME_OR_ID 來設定預設專案。 如果未設定為預設，或透過 git 組態挑選，則為必要專案。

全域參數

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

取得 Git 存放庫的詳細資料。

az repos show --repository
              [--detect {false, true}]
              [--open]
              [--org]
              [--project]

必要參數

--repository -r

存放庫的名稱或識別碼。

選擇性參數

--detect

自動偵測組織。

接受的值: false, true

--open

在網頁瀏覽器中開啟存放庫頁面。

預設值: False

--org --organization

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

--project -p

專案的名稱或識別碼。 您可以使用 az devops configure -d project=NAME_OR_ID 來設定預設專案。 如果未設定為預設，或透過 git 組態挑選，則為必要專案。

全域參數

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

更新 Git 存放庫。

az repos update --repository
                [--default-branch]
                [--detect {false, true}]
                [--name]
                [--org]
                [--project]

必要參數

--repository -r

存放庫的名稱或識別碼。

選擇性參數

--default-branch

要為存放庫設定的預設分支。 範例：'refs/heads/live' 或 'live'。

--detect

自動偵測組織。

接受的值: false, true

--name

存放庫的新名稱。

--org --organization

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

--project -p

專案的名稱或識別碼。 您可以使用 az devops configure -d project=NAME_OR_ID 來設定預設專案。 如果未設定為預設，或透過 git 組態挑選，則為必要專案。

全域參數

--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 來取得完整偵錯記錄。