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 config 自動取得，則為必要。

全域參數

--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 config 自動取得，則為必要。

--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 config 自動取得，則為必要。

全域參數

--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 config 自動取得，則為必要。

全域參數

--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 config 自動取得，則為必要。

全域參數

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