你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
az networkfabric fabric
注意
此参考是 Azure CLI(版本 2.49.0 或更高版本)的 managednetworkfabric 扩展的一部分。 该扩展将在首次运行 az networkfabric fabric 命令时自动安装。 详细了解扩展。
管理网络结构资源。
命令
名称 | 说明 | 类型 | 状态 |
---|---|---|---|
az networkfabric fabric commit-configuration |
给定 Network Fabric 实例的原子更新。 在 Fabric 级别同步 NFA 资源的更新。 |
扩展 | GA |
az networkfabric fabric create |
创建 Network Fabric 资源。 |
扩展 | GA |
az networkfabric fabric delete |
删除 Network Fabric 资源。 |
扩展 | GA |
az networkfabric fabric deprovision |
取消预配给定 Network Fabric 实例中的基础资源。 |
扩展 | GA |
az networkfabric fabric list |
列出提供资源组或订阅中的所有网络结构。 |
扩展 | GA |
az networkfabric fabric provision |
在给定的 Network Fabric 实例中预配基础资源。 |
扩展 | GA |
az networkfabric fabric show |
显示提供的 Network Fabric 资源的详细信息。 |
扩展 | GA |
az networkfabric fabric update |
更新 Network Fabric 资源。 |
扩展 | GA |
az networkfabric fabric upgrade |
升级给定 Network Fabric 实例中基础资源的版本。 |
扩展 | GA |
az networkfabric fabric validate-configuration |
验证给定 Network Fabric 实例中基础资源的配置。 |
扩展 | GA |
az networkfabric fabric wait |
将 CLI 置于等待状态,直到满足条件。 |
扩展 | GA |
az networkfabric fabric commit-configuration
给定 Network Fabric 实例的原子更新。 在 Fabric 级别同步 NFA 资源的更新。
az networkfabric fabric commit-configuration [--ids]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--resource-name]
[--subscription]
示例
提交配置
az networkfabric fabric commit-configuration --resource-group "example-rg" --resource-name "example-fabric"
可选参数
一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。
不等待长时间运行的操作完成。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
网络结构的名称。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az networkfabric fabric create
创建 Network Fabric 资源。
az networkfabric fabric create --fabric-asn
--ipv4-prefix
--managed-network-config
--nf-sku
--nfc-id
--resource-group
--resource-name
--server-count-per-rack
--ts-config
[--annotation]
[--fabric-version]
[--ipv6-prefix]
[--location]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--rack-count]
[--tags]
示例
使用选项 B 属性创建网络结构
az networkfabric fabric create --resource-group "example-rg" --location "westus3" --resource-name "example-fabric" --nf-sku "fab1" --fabric-version "1.x.x" --nfc-id "/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/Microsoft.ManagedNetworkFabric/networkFabricControllers/example-NFC" --fabric-asn 20 --ipv4-prefix 10.1.0.0/19 --rack-count 2 --server-count-per-rack 5 --ts-config "{primaryIpv4Prefix:'172.31.0.0/30',secondaryIpv4Prefix:'172.31.0.20/30',username:'****',password:'*****',serialNumber:'1234'}" --managed-network-config "{infrastructureVpnConfiguration:{networkToNetworkInterconnectId:'/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/Microsoft.ManagedNetworkFabric/networkFabrics/example-fabric/networkToNetworkInterconnects/example-nni',peeringOption:OptionB,optionBProperties:{routeTargets:{exportIpv4RouteTargets:['65046:10039'],exportIpv6RouteTargets:['65046:10039'],importIpv4RouteTargets:['65046:10039'],importIpv6RouteTargets:['65046:10039']}}},workloadVpnConfiguration:{networkToNetworkInterconnectId:'/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/Microsoft.ManagedNetworkFabric/networkFabrics/example-fabric/networkToNetworkInterconnects/example-nni',peeringOption:OptionB,optionBProperties:{routeTargets:{exportIpv4RouteTargets:['65046:10039'],exportIpv6RouteTargets:['65046:10039'],importIpv4RouteTargets:['65046:10039'],importIpv6RouteTargets:['65046:10039']}}}}"
使用选项 A 属性创建网络结构
az networkfabric fabric create --resource-group "example-rg" --location "westus3" --resource-name "example-fabric" --nf-sku "fab1" --fabric-version "1.x.x" --nfc-id "/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/Microsoft.ManagedNetworkFabric/networkFabricControllers/example-NFC" --fabric-asn 20 --ipv4-prefix "10.1.0.0/19" --rack-count 2 --server-count-per-rack 5 --ts-config "{primaryIpv4Prefix:'172.31.0.0/30',secondaryIpv4Prefix:'172.31.0.20/30',username:'****',password:'*****',serialNumber:1234}" --managed-network-config "{infrastructureVpnConfiguration:{networkToNetworkInterconnectId:'/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/Microsoft.ManagedNetworkFabric/networkFabrics/example-fabric/networkToNetworkInterconnects/example-nni',peeringOption:OptionA,optionAProperties:{bfdConfiguration:{multiplier:5,intervalInMilliSeconds:300},mtu:1500,vlanId:520,peerASN:65133,primaryIpv4Prefix:'172.31.0.0/31',secondaryIpv4Prefix:'172.31.0.20/31'}},workloadVpnConfiguration:{networkToNetworkInterconnectId:'/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/Microsoft.ManagedNetworkFabric/networkFabrics/example-fabric/networkToNetworkInterconnects/example-nni',peeringOption:OptionA,optionAProperties:{bfdConfiguration:{multiplier:5,intervalInMilliSeconds:300},mtu:1500,vlanId:520,peerASN:65133,primaryIpv4Prefix:'172.31.0.0/31',secondaryIpv4Prefix:'172.31.0.20/31',primaryIpv6Prefix:'3FFE:FFFF:0:CD30::a0/127',secondaryIpv6Prefix:'3FFE:FFFF:0:CD30::a0/127'}}}"
可以使用速记语法“??”查看特定父级下子参数的帮助文本。 有关速记语法的详细信息,请参阅 https://github.com/Azure/azure-cli/tree/dev/doc/shorthand_syntax.md 。
az networkfabric fabric create --ts-config "??"
az networkfabric fabric create --managed-network-config "{infrastructureVpnConfiguration:??"
az networkfabric fabric create --managed-network-config "{infrastructureVpnConfiguration:{option-b-properties:??"
必需参数
CE/PE 连接的 CE 设备的 ASN。 该值应介于 1 到 4294967295 之间。 示例:65123。
用于管理网络的 IPv4Prefix。 示例:10.1.0.0/19。
用于设置管理网络的配置。 支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
支持的网络构造 SKU。 SKU 确定它是单个/多机架网络结构。
NetworkFabricController 的 Azure 资源 ID 属于 NetworkFabric。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
网络结构的名称。
服务器数。可能的值为 1-16。
当前应用于终端服务器的网络和凭据配置。 支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
可选参数
基础资源的说明。
Network Fabric 的版本。
用于管理网络的 IPv6Prefix。 示例:3FFE:FFFF:0:CD40::/59。
未指定 Azure 区域的位置时,将使用资源组的位置。
不等待长时间运行的操作完成。
与 Network Fabric 关联的计算机架数。 可能的值为 1-8。
资源标记。 支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az networkfabric fabric delete
删除 Network Fabric 资源。
az networkfabric fabric delete [--ids]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--resource-name]
[--subscription]
示例
删除网络结构
az networkfabric fabric delete --resource-group "example-rg" --resource-name "example-fabric"
可选参数
一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。
不等待长时间运行的操作完成。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
网络结构的名称。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az networkfabric fabric deprovision
取消预配给定 Network Fabric 实例中的基础资源。
az networkfabric fabric deprovision [--ids]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--resource-name]
[--subscription]
示例
取消预配网络结构
az networkfabric fabric deprovision --resource-group "example-rg" --resource-name "example-fabric"
可选参数
一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。
不等待长时间运行的操作完成。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
网络结构的名称。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az networkfabric fabric list
列出提供资源组或订阅中的所有网络结构。
az networkfabric fabric list [--resource-group]
示例
列出资源组的网络构造
az networkfabric fabric list --resource-group "example-rg"
列出订阅的网络构造
az networkfabric fabric list --subscription "<subscriptionId>"
可选参数
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az networkfabric fabric provision
在给定的 Network Fabric 实例中预配基础资源。
az networkfabric fabric provision [--ids]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--resource-name]
[--subscription]
示例
预配网络结构
az networkfabric fabric provision --resource-group "example-rg" --resource-name "example-fabric"
可选参数
一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。
不等待长时间运行的操作完成。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
网络结构的名称。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az networkfabric fabric show
显示提供的 Network Fabric 资源的详细信息。
az networkfabric fabric show [--ids]
[--resource-group]
[--resource-name]
[--subscription]
示例
显示网络结构
az networkfabric fabric show --resource-group "example-rg" --resource-name "example-fabric"
可选参数
一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
网络结构的名称。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az networkfabric fabric update
更新 Network Fabric 资源。
az networkfabric fabric update [--annotation]
[--fabric-asn]
[--ids]
[--ipv4-prefix]
[--ipv6-prefix]
[--managed-network-config]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--rack-count]
[--resource-group]
[--resource-name]
[--server-count-per-rack]
[--subscription]
[--tags]
[--ts-config]
示例
更新 Network Fabric 选项 B 属性
az networkfabric fabric update --resource-group "example-rg" --resource-name "example-fabric" --fabric-asn 20 --ipv4-prefix 10.1.0.0/19 --rack-count 3 --server-count-per-rack 7 --ts-config "{primaryIpv4Prefix:'172.31.0.0/30',secondaryIpv4Prefix:'172.31.0.20/30',username:'****',password:'*****',serialNumber:'1234'}" --managed-network-config "{infrastructureVpnConfiguration:{networkToNetworkInterconnectId:'/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/Microsoft.ManagedNetworkFabric/networkFabrics/example-fabric/networkToNetworkInterconnects/example-nni',peeringOption:OptionB,optionBProperties:{routeTargets:{exportIpv4RouteTargets:['65046:10039'],exportIpv6RouteTargets:['65046:10039'],importIpv4RouteTargets:['65046:10039'],importIpv6RouteTargets:['65046:10039']}}},workloadVpnConfiguration:{networkToNetworkInterconnectId:'/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/Microsoft.ManagedNetworkFabric/networkFabrics/example-fabric/networkToNetworkInterconnects/example-nni',peeringOption:OptionB,optionBProperties:{routeTargets:{exportIpv4RouteTargets:['65046:10039'],exportIpv6RouteTargets:['65046:10039'],importIpv4RouteTargets:['65046:10039'],importIpv6RouteTargets:['65046:10039']}}}}"
更新网络结构选项 A 属性
az networkfabric fabric update --resource-group "example-rg" --resource-name "example-fabric" --fabric-asn 20 --ipv4-prefix "10.1.0.0/19" --rack-count 3 --server-count-per-rack 7 --ts-config "{primaryIpv4Prefix:'172.31.0.0/30',secondaryIpv4Prefix:'172.31.0.20/30',username:'****',password:'*****',serialNumber:1234}" --managed-network-config "{infrastructureVpnConfiguration:{networkToNetworkInterconnectId:'/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/Microsoft.ManagedNetworkFabric/networkFabrics/example-fabric/networkToNetworkInterconnects/example-nni',peeringOption:OptionA,optionAProperties:{bfdConfiguration:{multiplier:5,intervalInMilliSeconds:300},mtu:1500,vlanId:520,peerASN:65133,primaryIpv4Prefix:'172.31.0.0/31',secondaryIpv4Prefix:'172.31.0.20/31'}},workloadVpnConfiguration:{networkToNetworkInterconnectId:'/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/Microsoft.ManagedNetworkFabric/networkFabrics/example-fabric/networkToNetworkInterconnects/example-nni',peeringOption:OptionA,optionAProperties:{bfdConfiguration:{multiplier:5,intervalInMilliSeconds:300},mtu:1500,vlanId:520,peerASN:65133,primaryIpv4Prefix:'172.31.0.0/31',secondaryIpv4Prefix:'172.31.0.20/31'}}}"
可以使用速记语法“??”查看特定父级下子参数的帮助文本。 有关速记语法的详细信息,请参阅 https://github.com/Azure/azure-cli/tree/dev/doc/shorthand_syntax.md 。
az networkfabric fabric update --ts-config "??"
az networkfabric fabric update --managed-network-config "{infrastructureVpnConfiguration:??"
az networkfabric fabric update --managed-network-config "{infrastructureVpnConfiguration:{option-b-properties:??"
可选参数
基础资源的说明。
CE/PE 连接的 CE 设备的 ASN。 该值应介于 1 到 4294967295 之间。 示例:65123。
一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。
用于管理网络的 IPv4Prefix。 示例:10.1.0.0/19。
用于管理网络的 IPv6Prefix。 示例:3FFE:FFFF:0:CD40::/59。
用于设置管理网络的配置。 支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
不等待长时间运行的操作完成。
与 Network Fabric 关联的计算机架数。 可能的值为 1-8。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
网络结构的名称。
服务器数。可能的值为 1-16。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
资源标记支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
当前应用于终端服务器的网络和凭据配置。 支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az networkfabric fabric upgrade
升级给定 Network Fabric 实例中基础资源的版本。
az networkfabric fabric upgrade [--action {Complete, Start}]
[--ids]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--resource-name]
[--subscription]
[--version]
可选参数
升级构造时要执行的操作。
一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。
不等待长时间运行的操作完成。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
网络结构的名称。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
指定版本。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az networkfabric fabric validate-configuration
验证给定 Network Fabric 实例中基础资源的配置。
az networkfabric fabric validate-configuration [--ids]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--resource-name]
[--subscription]
[--validate-action {Cabling, Configuration, Connectivity}]
示例
验证配置
az networkfabric fabric validate-configuration -g "example-rg" --resource-name "example-nf" --validate-action "Cabling"
可选参数
一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。
不等待长时间运行的操作完成。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
网络结构的名称。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
验证要执行的操作。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az networkfabric fabric wait
将 CLI 置于等待状态,直到满足条件。
az networkfabric fabric wait [--created]
[--custom]
[--deleted]
[--exists]
[--ids]
[--interval]
[--resource-group]
[--resource-name]
[--subscription]
[--timeout]
[--updated]
可选参数
等待在“Succeeded”中使用“provisioningState”创建。
等待条件满足自定义 JMESPath 查询。 例如 provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running']。
等到删除为止。
等待资源存在。
一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。
轮询间隔(以秒为单位)。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
网络结构的名称。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
最大等待(以秒为单位)。
等到 provisioningState 更新为“Succeeded”。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。