你当前正在访问 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>]
   [-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>]
   [-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"
New-AzVirtualHub -VirtualWan $virtualWan -ResourceGroupName "testRG" -Name "westushub" -AddressPrefix "10.0.1.0/24" -HubRoutingPreference "VpnGateway"

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。

参数

-AddressPrefix

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AsJob

在后台运行 cmdlet

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-HubRoutingPreference

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

Type:String
Accepted values:ExpressRoute, VpnGateway, ASPath
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-HubVnetConnection

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

Type:PSHubVirtualNetworkConnection[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Location

位置。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Name

资源名称。

Type:String
Aliases:ResourceName, VirtualHubName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PreferredRoutingGateway

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

Type:String
Accepted values:ExpressRoute, VpnGateway
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

资源组名称。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RouteTable

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

Type:PSVirtualHubRouteTable
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Sku

虚拟中心的 SKU。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Tag

表示资源标记的哈希表。

Type:Hashtable
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-VirtualWan

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

Type:PSVirtualWan
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-VirtualWanId

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

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

显示在此 cmdlet 运行的情况下将会发生什么。 此 cmdlet 未运行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

输入

PSVirtualWan

String

输出

PSVirtualHub