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

az stack-hci-vm network nsg rule

注意

此参考是 Azure CLI(版本 2.15.0 或更高版本)的 stack-hci-vm 扩展的一部分。 该扩展将在首次运行 az stack-hci-vm network nsg rule 命令时自动安装。 详细了解扩展。

管理网络安全组规则。

命令

名称 说明 类型 状态
az stack-hci-vm network nsg rule create

创建网络安全组规则。

扩展 GA
az stack-hci-vm network nsg rule delete

删除网络安全组规则。

扩展 GA
az stack-hci-vm network nsg rule list

列出网络安全组中的所有规则。

扩展 GA
az stack-hci-vm network nsg rule show

获取网络安全组规则的详细信息。

扩展 GA
az stack-hci-vm network nsg rule update

更新网络安全组规则。

扩展 GA

az stack-hci-vm network nsg rule create

创建网络安全组规则。

az stack-hci-vm network nsg rule create --custom-location
                                        --name
                                        --nsg-name
                                        --priority
                                        --resource-group
                                        [--access {Allow, Deny}]
                                        [--description]
                                        [--destination-address-prefixes]
                                        [--destination-port-ranges]
                                        [--direction {Inbound, Outbound}]
                                        [--location]
                                        [--polling-interval]
                                        [--protocol {*, Icmp, Tcp, Udp}]
                                        [--source-address-prefixes]
                                        [--source-port-ranges]

示例

创建优先级最高的基本“允许”NSG 规则。

az stack-hci-vm network nsg rule create -g MyResourceGroup --nsg-name MyNsg -n MyNsgRule --priority 100 --custom-location $customLocationId

必需参数

--custom-location

扩展位置的 ID。

--name -n

网络安全组规则的名称。

--nsg-name

网络安全组的名称。

--priority

规则的优先级。 该值可以介于 100 和 4096 之间。 对于集合中的每个规则,优先级编号必须是唯一的。 优先级编号越低,规则优先级越高。

--resource-group -g

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

可选参数

--access

允许或拒绝网络流量。

接受的值: Allow, Deny
默认值: Allow
--description

此规则的说明。 限制为 140 个字符。

--destination-address-prefixes

目标地址前缀。 CIDR 或目标 IP 范围。

默认值: ['*']
--destination-port-ranges

目标端口范围。 介于 0 和 65535 之间的整数或范围。 星号“*”也可用于匹配所有端口。

默认值: ['80']
--direction

规则的方向。 该方向指定在传入或传出流量上是否评估规则。

接受的值: Inbound, Outbound
默认值: Inbound
--location -l

如果未指定位置,则使用资源组的位置。

--polling-interval

长时间运行的操作的 ARM 轮询间隔。

--protocol

此规则适用于的网络协议。

接受的值: *, Icmp, Tcp, Udp
默认值: *
--source-address-prefixes

CIDR 或源 IP 范围。

默认值: ['*']
--source-port-ranges

源端口范围。 介于 0 和 65535 之间的整数或范围。 星号“*”也可用于匹配所有端口。

默认值: ['*']
全局参数
--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 stack-hci-vm network nsg rule delete

删除网络安全组规则。

az stack-hci-vm network nsg rule delete --name
                                        --nsg-name
                                        --resource-group
                                        [--polling-interval]
                                        [--yes]

示例

删除网络安全组规则

az stack-hci-vm network nsg rule delete -g MyResourceGroup --nsg-name MyNsg -n MyNsgRule

必需参数

--name -n

网络安全组规则的名称。

--nsg-name

网络安全组的名称。

--resource-group -g

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

可选参数

--polling-interval

长时间运行的操作的 ARM 轮询间隔。

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

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

--verbose

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

az stack-hci-vm network nsg rule list

列出网络安全组中的所有规则。

az stack-hci-vm network nsg rule list --nsg-name
                                      --resource-group

示例

列出网络安全组中的所有规则

az stack-hci-vm network nsg rule list -g MyResourceGroup --nsg-name MyNsg

必需参数

--nsg-name

网络安全组的名称。

--resource-group -g

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

全局参数
--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 stack-hci-vm network nsg rule show

获取网络安全组规则的详细信息。

az stack-hci-vm network nsg rule show --nsg-name
                                      [--ids]
                                      [--name]
                                      [--resource-group]
                                      [--subscription]

示例

获取网络安全组规则的详细信息

az stack-hci-vm network nsg rule show -g MyResourceGroup --nsg-name MyNsg -n MyNsgRule

必需参数

--nsg-name

网络安全组的名称。

可选参数

--ids

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

--name -n

网络安全组规则的名称。

--resource-group -g

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

--subscription

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

全局参数
--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 stack-hci-vm network nsg rule update

更新网络安全组规则。

az stack-hci-vm network nsg rule update --name
                                        --nsg-name
                                        --resource-group
                                        [--access {Allow, Deny}]
                                        [--add]
                                        [--description]
                                        [--destination-address-prefixes]
                                        [--destination-port-ranges]
                                        [--direction {Inbound, Outbound}]
                                        [--force-string]
                                        [--polling-interval]
                                        [--priority]
                                        [--protocol {*, Icmp, Tcp, Udp}]
                                        [--remove]
                                        [--set]
                                        [--source-address-prefixes]
                                        [--source-port-ranges]

示例

使用新的通配符目标地址前缀更新 NSG 规则

az stack-hci-vm network nsg rule update -g MyResourceGroup --nsg-name MyNsg -n MyNsgRule --destination-address-prefix '*'

更新网络安全组规则

az stack-hci-vm network nsg rule update --name MyNsgRule --nsg-name MyNsg --resource-group MyResourceGroup --source-address-prefixes 208.130.28/24

必需参数

--name -n

网络安全组规则的名称。

--nsg-name

网络安全组的名称。

--resource-group -g

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

可选参数

--access

允许或拒绝网络流量。

接受的值: Allow, Deny
--add

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

默认值: []
--description

此规则的说明。 限制为 140 个字符。

--destination-address-prefixes

目标地址前缀。 CIDR 或目标 IP 范围。

--destination-port-ranges

目标端口范围。 介于 0 和 65535 之间的整数或范围。 星号“*”也可用于匹配所有端口。

--direction

规则的方向。 该方向指定在传入或传出流量上是否评估规则。

接受的值: Inbound, Outbound
--force-string

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

默认值: False
--polling-interval

长时间运行的操作的 ARM 轮询间隔。

--priority

规则的优先级。 该值可以介于 100 和 4096 之间。 对于集合中的每个规则,优先级编号必须是唯一的。 优先级编号越低,规则优先级越高。

--protocol

此规则适用于的网络协议。

接受的值: *, Icmp, Tcp, Udp
--remove

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

默认值: []
--set

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

默认值: []
--source-address-prefixes

CIDR 或源 IP 范围。

--source-port-ranges

源端口范围。 介于 0 和 65535 之间的整数或范围。 星号“*”也可用于匹配所有端口。

全局参数
--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 获取完整的调试日志。