az pipelines variable-group variable

注意

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

管理變數群組中的變數。

命令

名稱	Description	類型	狀態
az pipelines variable-group variable create	將變數新增至變數群組。	擴充	GA
az pipelines variable-group variable delete	從變數群組中刪除變數。	擴充	GA
az pipelines variable-group variable list	列出變數群組中的變數。	擴充	GA
az pipelines variable-group variable update	更新變數群組中的變數。	擴充	GA

az pipelines variable-group variable create

將變數新增至變數群組。

az pipelines variable-group variable create --group-id
                                            --name
                                            [--detect {false, true}]
                                            [--org]
                                            [--project]
                                            [--secret {false, true}]
                                            [--value]

必要參數

--group-id --id

變數群組的識別碼。

--name

變數的名稱。

選擇性參數

--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 組態挑選，則為必要專案。

--secret

如果變數的值是秘密，則為 。

接受的值: false, true

--value

變數的值。 針對秘密變數，如果未指定 --value 參數，則會從前面加上 AZURE_DEVOPS_EXT_PIPELINE_VAR_ 的環境變數中挑選，否則系統會提示使用者透過標準輸入輸入。 例如，PersonalAccessToken 可以使用環境變數AZURE_DEVOPS_EXT_PIPELINE_VAR_PersonalAccessToken輸入。

全域參數

--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 pipelines variable-group variable delete

從變數群組中刪除變數。

az pipelines variable-group variable delete --group-id
                                            --name
                                            [--detect {false, true}]
                                            [--org]
                                            [--project]
                                            [--yes]

必要參數

--group-id --id

變數群組的識別碼。

--name

變數的名稱。

選擇性參數

--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 pipelines variable-group variable list

列出變數群組中的變數。

az pipelines variable-group variable list --group-id
                                          [--detect {false, true}]
                                          [--org]
                                          [--project]

必要參數

--group-id --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 組態挑選，則為必要專案。

全域參數

--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 pipelines variable-group variable update

更新變數群組中的變數。

az pipelines variable-group variable update --group-id
                                            --name
                                            [--detect {false, true}]
                                            [--new-name]
                                            [--org]
                                            [--project]
                                            [--prompt-value {false, true}]
                                            [--secret {false, true}]
                                            [--value]

必要參數

--group-id --id

變數群組的識別碼。

--name

變數的名稱。

選擇性參數

--detect

自動偵測組織。

接受的值: false, true

--new-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 組態挑選，則為必要專案。

--prompt-value

將它設定為 True，以使用環境變數或透過標準輸入提示來更新秘密變數的值。

接受的值: false, true

預設值: False

--secret

如果變數的值是秘密，則為 。

接受的值: false, true

--value

變數的新值。 針對秘密變數，如果未指定 --value 參數，則會從前面加上 AZURE_DEVOPS_EXT_PIPELINE_VAR_ 的環境變數中挑選，否則系統會提示使用者透過標準輸入輸入。 例如，PersonalAccessToken 可以使用環境變數AZURE_DEVOPS_EXT_PIPELINE_VAR_PersonalAccessToken輸入。

全域參數

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