你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az devops admin banner

注意

此参考是 Azure CLI（版本 2.30.0 或更高版本）的 azure-devops 扩展的一部分。 该扩展将在首次运行 az devops admin banner 命令时自动安装。 详细了解扩展。

管理组织横幅。

命令

名称	说明	类型	状态
az devops admin banner add	添加新横幅并立即显示它。	分机	GA
az devops admin banner list	列出横幅。	分机	GA
az devops admin banner remove	删除横幅。	分机	GA
az devops admin banner show	显示横幅的详细信息。	分机	GA
az devops admin banner update	更新横幅的消息、级别或到期日期。	分机	GA

az devops admin banner add

添加新横幅并立即显示它。

az devops admin banner add --message
                           [--detect {false, true}]
                           [--expiration]
                           [--id]
                           [--org]
                           [--type {error, info, warning}]

必需参数

--message -m

要显示在横幅中的消息（字符串）。

可选参数

--detect

自动检测组织。

接受的值: false, true

--expiration

不应再向用户显示横幅的日期/时间。 如果未设置，横幅不会自动过期，并且必须使用 remove 命令删除。 示例：“2019-06-10 17：21：00 UTC”、“2019-06-10”。

--id

新横幅的标识符。 稍后需要此标识符来更改或删除消息。 如果未指定唯一标识符，则会自动创建一个标识符。

--org --organization

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

--type -t

要演示的横幅类型。 默认值为“info”。

接受的值: error, info, warning

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az devops admin banner list

列出横幅。

az devops admin banner list [--detect {false, true}]
                            [--org]

可选参数

--detect

自动检测组织。

接受的值: false, true

--org --organization

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

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az devops admin banner remove

删除横幅。

az devops admin banner remove --id
                              [--detect {false, true}]
                              [--org]

必需参数

--id

要删除的横幅的 ID。

可选参数

--detect

自动检测组织。

接受的值: false, true

--org --organization

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

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az devops admin banner show

显示横幅的详细信息。

az devops admin banner show --id
                            [--detect {false, true}]
                            [--org]

必需参数

--id

横幅的标识符。

可选参数

--detect

自动检测组织。

接受的值: false, true

--org --organization

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

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az devops admin banner update

更新横幅的消息、级别或到期日期。

az devops admin banner update --id
                              [--detect {false, true}]
                              [--expiration]
                              [--message]
                              [--org]
                              [--type {error, info, warning}]

必需参数

--id

要更新的横幅的 ID。

可选参数

--detect

自动检测组织。

接受的值: false, true

--expiration

不应再向用户显示横幅的日期/时间。 若要取消设置横幅的过期时间，请为此参数提供空值。 示例：“2019-06-10 17：21：00 UTC”、“2019-06-10”。

--message -m

要显示在横幅中的消息（字符串）。

--org --organization

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

--type -t

要演示的横幅类型。 默认值为“info”。

接受的值: error, info, warning

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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