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

New-AzVirtualHub

创建 Azure VirtualHub 资源。

语法

New-AzVirtualHub
   -ResourceGroupName <String>
   -Name <String>
   -VirtualWan <PSVirtualWan>
   -AddressPrefix <String>
   -Location <String>
   [-HubVnetConnection <PSHubVirtualNetworkConnection[]>]
   [-RouteTable <PSVirtualHubRouteTable>]
   [-Tag <Hashtable>]
   [-Sku <String>]
   [-PreferredRoutingGateway <String>]
   [-HubRoutingPreference <String>]
   [-VirtualRouterAsn <UInt32>]
   [-VirtualRouterAutoScaleConfiguration <PSVirtualRouterAutoScaleConfiguration>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzVirtualHub
   -ResourceGroupName <String>
   -Name <String>
   -VirtualWanId <String>
   -AddressPrefix <String>
   -Location <String>
   [-HubVnetConnection <PSHubVirtualNetworkConnection[]>]
   [-RouteTable <PSVirtualHubRouteTable>]
   [-Tag <Hashtable>]
   [-Sku <String>]
   [-PreferredRoutingGateway <String>]
   [-HubRoutingPreference <String>]
   [-VirtualRouterAsn <UInt32>]
   [-VirtualRouterAutoScaleConfiguration <PSVirtualRouterAutoScaleConfiguration>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

创建 Azure VirtualHub 资源。

示例

示例 1

New-AzResourceGroup -Location "West US" -Name "testRG"
$virtualWan = New-AzVirtualWan -ResourceGroupName "testRG" -Name "myVirtualWAN" -Location "West US"
New-AzVirtualHub -VirtualWan $virtualWan -ResourceGroupName "testRG" -Name "westushub" -AddressPrefix "10.0.1.0/24"

VirtualWan                : /subscriptions/{subscriptionId}resourceGroups/testRG/providers/Microsoft.Network/virtualWans/myVirtualWAN
ResourceGroupName         : testRG
Name                      : westushub
Id                        : /subscriptions/{subscriptionId}resourceGroups/testRG/providers/Microsoft.Network/virtualHubs/westushub
AddressPrefix             : 10.0.1.0/24
RouteTable                : 
VirtualNetworkConnections : {}
RouteTables                           : {}
Location                  : West US
Sku                  : Standard
PreferredRoutingGateway   : ExpressRoute
HubRoutingPreference      : ExpressRoute
Type                      : Microsoft.Network/virtualHubs
ProvisioningState         : Succeeded

上述操作将在 Azure 中的资源组中创建资源组“testRG”、“虚拟 WAN”和“美国西部虚拟中心”。 虚拟中心将具有地址空间“10.0.1.0/24”。

示例 2

New-AzResourceGroup -Location "West US" -Name "testRG"
$virtualWan = New-AzVirtualWan -ResourceGroupName "testRG" -Name "myVirtualWAN" -Location "West US"
New-AzVirtualHub -VirtualWanId $virtualWan.Id -ResourceGroupName "testRG" -Name "westushub" -AddressPrefix "10.0.1.0/24" -Location "West US"

VirtualWan                : /subscriptions/{subscriptionId}resourceGroups/testRG/providers/Microsoft.Network/virtualWans/myVirtualWAN
ResourceGroupName         : testRG
Name                      : westushub
Id                        : /subscriptions/{subscriptionId}resourceGroups/testRG/providers/Microsoft.Network/virtualHubs/westushub
AddressPrefix             : 10.0.1.0/24
RouteTable                : 
VirtualNetworkConnections : {}
RouteTables                           : {}
Location                  : West US
Sku                  : Standard
PreferredRoutingGateway   : ExpressRoute
HubRoutingPreference      : ExpressRoute
Type                      : Microsoft.Network/virtualHubs
ProvisioningState         : Succeeded

上述操作将在 Azure 中的资源组中创建资源组“testRG”、“虚拟 WAN”和“美国西部虚拟中心”。 虚拟中心将具有地址空间“10.0.1.0/24”。

此示例类似于示例 1,但使用资源 ID 引用创建虚拟中心所需的虚拟 WAN。

示例 3

New-AzResourceGroup -Location "West US" -Name "testRG"
$virtualWan = New-AzVirtualWan -ResourceGroupName "testRG" -Name "myVirtualWAN" -Location "West US"
$route1 = New-AzVirtualHubRoute -AddressPrefix @("10.0.0.0/16", "11.0.0.0/16") -NextHopIpAddress "12.0.0.5"
$route2 = New-AzVirtualHubRoute -AddressPrefix @("13.0.0.0/16") -NextHopIpAddress "14.0.0.5"
$routeTable = New-AzVirtualHubRouteTable -Route @($route1, $route2)
New-AzVirtualHub -VirtualWanId $virtualWan.Id -ResourceGroupName "testRG" -Name "westushub" -AddressPrefix "10.0.1.0/24" -RouteTable $routeTable

VirtualWan                : /subscriptions/{subscriptionId}resourceGroups/testRG/providers/Microsoft.Network/virtualWans/myVirtualWAN
ResourceGroupName         : testRG
Name                      : westushub
Id                        : /subscriptions/{subscriptionId}resourceGroups/testRG/providers/Microsoft.Network/virtualHubs/westushub
AddressPrefix             : 10.0.1.0/24
RouteTable                : Microsoft.Azure.Commands.Network.Models.PSVirtualHubRouteTable
VirtualNetworkConnections : {}
RouteTables                           : {}
Location                  : West US
Sku                  : Standard
PreferredRoutingGateway   : ExpressRoute
HubRoutingPreference      : ExpressRoute
Type                      : Microsoft.Network/virtualHubs
ProvisioningState         : Succeeded

上述操作将在 Azure 中的资源组中创建资源组“testRG”、“虚拟 WAN”和“美国西部虚拟中心”。 虚拟中心将附加地址空间“10.0.1.0/24”和路由表。

此示例类似于示例 2,但也将路由表附加到虚拟中心。

示例 4

New-AzResourceGroup -Location "West US" -Name "testRG"
$virtualWan = New-AzVirtualWan -ResourceGroupName "testRG" -Name "myVirtualWAN" -Location "West US"
$autoscale = New-AzVirtualRouterAutoScaleConfiguration -MinCapacity 3
New-AzVirtualHub -VirtualWan $virtualWan -ResourceGroupName "testRG" -Name "westushub" -AddressPrefix "10.0.1.0/24" -HubRoutingPreference "VpnGateway" -VirtualRouterAutoScaleConfiguration $autoscale

VirtualWan                : /subscriptions/{subscriptionId}resourceGroups/testRG/providers/Microsoft.Network/virtualWans/myVirtualWAN
ResourceGroupName         : testRG
Name                      : westushub
Id                        : /subscriptions/{subscriptionId}resourceGroups/testRG/providers/Microsoft.Network/virtualHubs/westushub
AddressPrefix             : 10.0.1.0/24
RouteTable                :
Location                  : West US
Sku                  : Standard 
HubRoutingPreference      : VpnGateway
VirtualNetworkConnections : {}
Location                  : West US
Type                      : Microsoft.Network/virtualHubs
ProvisioningState         : Succeeded

上述操作将在 Azure 中的资源组中创建资源组“testRG”、“虚拟 WAN”和“美国西部虚拟中心”。 虚拟中心将首选路由网关作为 VPNGateway 和最小容量 3。

参数

-AddressPrefix

此虚拟中心的地址空间字符串。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-AsJob

在后台运行 cmdlet

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:IAzureContextContainer
别名:AzContext, AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-HubRoutingPreference

用于路由流量的虚拟中心路由首选项

类型:String
接受的值:ExpressRoute, VpnGateway, ASPath
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-HubVnetConnection

与此虚拟中心关联的中心虚拟网络连接。

类型:PSHubVirtualNetworkConnection[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Location

数据库。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Name

资源名称。

类型:String
别名:ResourceName, VirtualHubName
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-PreferredRoutingGateway

首选路由网关,用于从 VNET 路由本地流量(已弃用,请使用 HubRoutingPreference)

类型:String
接受的值:ExpressRoute, VpnGateway
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ResourceGroupName

资源组名称。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-RouteTable

与此虚拟中心关联的路由表。

类型:PSVirtualHubRouteTable
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Sku

虚拟中心的 SKU。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Tag

表示资源标记的哈希表。

类型:Hashtable
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-VirtualRouterAsn

此虚拟中心的 ASN

类型:UInt32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-VirtualRouterAutoScaleConfiguration

中心路由器的自动缩放配置

类型:PSVirtualRouterAutoScaleConfiguration
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-VirtualWan

此中心链接到的虚拟 wan 对象。

类型:PSVirtualWan
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-VirtualWanId

此中心链接到的虚拟 wan 对象的 ID。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

PSVirtualWan

String

输出

PSVirtualHub