通过

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

az sql vm group ag-listener

管理 SQL 可用性组侦听器。

命令

名称 说明 类型 Status
az sql vm group ag-listener create

创建可用性组侦听器。

 Core GA
az sql vm group ag-listener delete

删除可用性组侦听器。

 Core GA
az sql vm group ag-listener list

列出 SQL 虚拟机组中的所有可用性组侦听器。

 Core GA
az sql vm group ag-listener show

获取可用性组侦听器。

 Core GA
az sql vm group ag-listener update

更新可用性组侦听器。

 Core GA

az sql vm group ag-listener create

编辑

创建可用性组侦听器。

az sql vm group ag-listener create --ag-name
                                   --group-name
                                   --ip-address
                                   --load-balancer
                                   --name
                                   --probe-port
                                   --resource-group
                                   --sqlvms
                                   --subnet
                                   [--port]
                                   [--public-ip]
                                   [--vnet-name]

示例

创建可用性组侦听器。 请注意，SQL 虚拟机与 SQL 虚拟机组位于同一资源组中。

az sql vm group ag-listener create -n aglistenertest -g myresourcegroup --ag-name agname --group-name sqlvmgroup --ip-address 10.0.0.11 --load-balancer '/subscriptions/{yoursubscription}/resourceGroups/{yourrg}/providers/Microsoft.Network/loadBalancers/{lbname}' --probe-port 59999 --subnet '/subscriptions/{yoursubscription}/resourceGroups/{yourrg}/providers/Microsoft.Network/virtualNetworks/{vnname}/subnets/{subnetname}' --sqlvms sqlvm1 sqlvm2

创建可用性组侦听器。 请注意，所有资源都位于同一资源组中。

az sql vm group ag-listener create -n aglistenertest -g myresourcegroup --ag-name agname --group-name sqlvmgroup --ip-address 10.0.0.11 --load-balancer {lbname} --probe-port 59999 --subnet {subnetname} --vnet-name {vnname} --sqlvms sqlvm1 sqlvm2

必需参数

--ag-name -a

可用性组的名称。 请参阅 https://free.blessedness.top/sql/database-engine/availability-groups/windows/use-the-availability-group-wizard-sql-server-management-studio?view=sql-server-2017 来创建和可用性组。

--group-name -r

SQL 虚拟机组的名称。

--ip-address -i

绑定到可用性组侦听器的专用 IP 地址。

属性 值
Parameter group: Load Balancer Configuration Arguments
--load-balancer -b

负载均衡器的名称或资源 ID。

属性 值
Parameter group: Load Balancer Configuration Arguments
--name -n

可用性组侦听器的名称。

--probe-port -e

探测端口。

属性 值
Parameter group: Load Balancer Configuration Arguments
--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

--sqlvms -q

注册到可用性组的 SQL 虚拟机实例名称或资源 ID 的空间分隔列表。

属性 值
Parameter group: Load Balancer Configuration Arguments
--subnet -u

要包含在专用 IP 中的子网的名称或资源 ID。

属性 值
Parameter group: Load Balancer Configuration Arguments

可选参数

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

--port -p

侦听器端口。

属性 值
Parameter group: SQL Connectivity Update Settings Arguments
默认值: 1433
--public-ip -c

公共 IP 的名称或资源 ID。

属性 值
Parameter group: Load Balancer Configuration Arguments
--vnet-name

虚拟网络的名称。 仅当提供子网的名称时提供。

属性 值
Parameter group: Load Balancer Configuration Arguments
全局参数
--debug

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

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: 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 sql vm group ag-listener delete

编辑

删除可用性组侦听器。

az sql vm group ag-listener delete --group-name
                                   [--ids]
                                   [--name]
                                   [--resource-group]
                                   [--subscription]
                                   [--yes]

必需参数

--group-name -r

SQL 虚拟机组的名称。

可选参数

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

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

属性 值
Parameter group: Resource Id Arguments
--name -n

可用性组侦听器的名称。

属性 值
Parameter group: Resource Id Arguments
--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

属性 值
Parameter group: Resource Id Arguments
--subscription

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

属性 值
Parameter group: Resource Id Arguments
--yes -y

不要提示确认。

属性 值
默认值: False
全局参数
--debug

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

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性 值
默认值: False
--output -o

输出格式。

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

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

--verbose

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

属性 值
默认值: False

az sql vm group ag-listener list

编辑

列出 SQL 虚拟机组中的所有可用性组侦听器。

az sql vm group ag-listener list --group-name
                                 --resource-group

必需参数

--group-name -r

SQL 虚拟机组的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

全局参数
--debug

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

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: 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 sql vm group ag-listener show

编辑

获取可用性组侦听器。

az sql vm group ag-listener show --group-name
                                 [--expand {*, AssessmentSettings, AutoBackupSettings, AutoPatchingSettings, KeyVaultCredentialSettings, ServerConfigurationsManagementSettings}]
                                 [--ids]
                                 [--name]
                                 [--resource-group]
                                 [--subscription]

必需参数

--group-name -r

SQL 虚拟机组的名称。

可选参数

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

--expand

获取 SQLIaaSExtension 配置设置。 若要查看所有设置，请使用 *。 若要仅选择几个设置，必须以空格分隔。

属性 值
接受的值: *, AssessmentSettings, AutoBackupSettings, AutoPatchingSettings, KeyVaultCredentialSettings, ServerConfigurationsManagementSettings
--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

属性 值
Parameter group: Resource Id Arguments
--name -n

可用性组侦听器的名称。

属性 值
Parameter group: Resource Id Arguments
--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

属性 值
Parameter group: Resource Id Arguments
--subscription

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

属性 值
Parameter group: Resource Id Arguments
全局参数
--debug

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

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性 值
默认值: False
--output -o

输出格式。

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

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

--verbose

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

属性 值
默认值: False

az sql vm group ag-listener update

编辑

更新可用性组侦听器。

az sql vm group ag-listener update --group-name
                                   [--add]
                                   [--force-string]
                                   [--ids]
                                   [--name]
                                   [--remove]
                                   [--resource-group]
                                   [--set]
                                   [--sqlvms]
                                   [--subscription]

示例

替换可用性组中的 SQL 虚拟机。

az sql vm group ag-listener update -n aglistenertest -g myresourcegroup --sqlvms sqlvm3 sqlvm4 --group-name mygroup

必需参数

--group-name -r

SQL 虚拟机组的名称。

可选参数

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

--add

通过指定路径和键值对将对象添加到对象列表。 示例：--add property.listProperty <key=value, string or JSON string>。

属性 值
Parameter group: Generic Update Arguments
默认值: []
--force-string

使用“set”或“add”时，保留字符串文本，而不是尝试转换为 JSON。

属性 值
Parameter group: Generic Update Arguments
默认值: False
--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

属性 值
Parameter group: Resource Id Arguments
--name -n

可用性组侦听器的名称。

属性 值
Parameter group: Resource Id Arguments
--remove

从列表中删除属性或元素。 示例： --remove property.list <indexToRemove> OR --remove propertyToRemove.

属性 值
Parameter group: Generic Update Arguments
默认值: []
--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

属性 值
Parameter group: Resource Id Arguments
--set

通过指定要设置的属性路径和值来更新对象。 示例：--set property1.property2=<value>。

属性 值
Parameter group: Generic Update Arguments
默认值: []
--sqlvms -q

注册到可用性组的 SQL 虚拟机实例名称或资源 ID 的空间分隔列表。

属性 值
Parameter group: Load Balancer Configuration Arguments
--subscription

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

属性 值
Parameter group: Resource Id Arguments
全局参数
--debug

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

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性 值
默认值: False
--output -o

输出格式。

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

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

--verbose

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

属性 值
默认值: False