az pipelines variable-group variable

Note

This reference is part of the azure-devops extension for the Azure CLI (version 2.30.0 or higher). 该扩展将在首次运行 az pipelines variable-group variable 命令时自动安装。 Learn more about extensions.

管理变量组中的变量。

命令

名称	说明	类型	Status
az pipelines variable-group variable create	将变量添加到变量组。	Extension	GA
az pipelines variable-group variable delete	从变量组中删除变量。	Extension	GA
az pipelines variable-group variable list	列出变量组中的变量。	Extension	GA
az pipelines variable-group variable update	更新变量组中的变量。	Extension	GA

az pipelines variable-group variable create

将变量添加到变量组。

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

必需参数

--group-id --id

变量组的 ID。

--name

变量的名称。

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--detect

自动检测组织。

属性	值
接受的值:	false, true

--org --organization

Azure DevOps 组织 URL。 可以使用 az devops configure -d organization=ORG_URL 配置默认组织。 如果未配置为默认或通过 git 配置选取，则为必需。示例：https://dev.azure.com/MyOrganizationName/。

--project -p

项目的名称或 ID。 可以使用 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

提高日志记录详细程度以显示所有调试日志。

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

Output format.

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性	值
默认值:	False

az pipelines variable-group variable delete

从变量组中删除变量。

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

必需参数

--group-id --id

变量组的 ID。

--name

变量的名称。

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--detect

自动检测组织。

属性	值
接受的值:	false, true

--org --organization

Azure DevOps 组织 URL。 可以使用 az devops configure -d organization=ORG_URL 配置默认组织。 如果未配置为默认或通过 git 配置选取，则为必需。示例：https://dev.azure.com/MyOrganizationName/。

--project -p

项目的名称或 ID。 可以使用 az devops configure -d project=NAME_OR_ID 配置默认项目。 如果未配置为默认或通过 git 配置进行选取，则为必需。

--yes -y

不要提示确认。

属性	值
默认值:	False

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

Output format.

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性	值
默认值:	False

az pipelines variable-group variable list

列出变量组中的变量。

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

必需参数

--group-id --id

变量组的 ID。

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--detect

自动检测组织。

属性	值
接受的值:	false, true

--org --organization

Azure DevOps 组织 URL。 可以使用 az devops configure -d organization=ORG_URL 配置默认组织。 如果未配置为默认或通过 git 配置选取，则为必需。示例：https://dev.azure.com/MyOrganizationName/。

--project -p

项目的名称或 ID。 可以使用 az devops configure -d project=NAME_OR_ID 配置默认项目。 如果未配置为默认或通过 git 配置进行选取，则为必需。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

Output format.

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性	值
默认值:	False

az pipelines variable-group variable update

更新变量组中的变量。

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

必需参数

--group-id --id

变量组的 ID。

--name

变量的名称。

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

项目的名称或 ID。 可以使用 az devops configure -d project=NAME_OR_ID 配置默认项目。 如果未配置为默认或通过 git 配置进行选取，则为必需。

--prompt-value

将其设置为 True 以使用环境变量或通过标准输入提示更新机密变量的值。

属性	值
默认值:	False
接受的值:	false, true

--secret

如果变量的值是机密。

属性	值
接受的值:	false, true

--value

变量的新值。 对于机密变量，如果未提供 --value 参数，则会从带有AZURE_DEVOPS_EXT_PIPELINE_VAR_前缀的环境变量中选取它，否则系统会提示用户通过标准输入输入它。 例如，PersonalAccessToken 可以使用环境变量AZURE_DEVOPS_EXT_PIPELINE_VAR_PersonalAccessToken进行输入。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

Output format.

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性	值
默认值:	False