New-AzVirtualHub

  • 參考
模組:
Az.Network

建立 Azure VirtualHub 資源。

Syntax

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

Description

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

上述會建立資源群組 「testRG」、虛擬 WAN 和美國西部的虛擬中樞，並在 Azure 中的該資源群組中建立虛擬中樞。 虛擬中樞會有位址空間 「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

上述會建立資源群組 「testRG」、虛擬 WAN 和美國西部的虛擬中樞，並在 Azure 中的該資源群組中建立虛擬中樞。 虛擬中樞會有位址空間 「10.0.1.0/24」。。

此範例類似於範例 1，但會使用資源標識符來參考建立虛擬中樞所需的虛擬 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

上述會建立資源群組 「testRG」、虛擬 WAN 和美國西部的虛擬中樞，並在 Azure 中的該資源群組中建立虛擬中樞。 虛擬中樞會附加位址空間 「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

上述會建立資源群組 「testRG」、虛擬 WAN 和美國西部的虛擬中樞，並在 Azure 中的該資源群組中建立虛擬中樞。 虛擬中樞將偏好路由網關作為 VPNGateway 和最小容量 3。

參數

-AddressPrefix

此虛擬中樞的位址空間字串。

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

-AsJob

在背景執行 Cmdlet

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

-Confirm

執行 Cmdlet 之前先提示您確認。

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

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

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

-HubRoutingPreference

用來路由流量的虛擬中樞路由喜好設定

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

-HubVnetConnection

與此虛擬中樞相關聯的中樞虛擬網路連線。

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

-Location

位置。

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

-Name

資源名稱。

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

-PreferredRoutingGateway

慣用路由網關將內部部署流量從 VNET 路由傳送（已淘汰，請使用 HubRoutingPreference）

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

-ResourceGroupName

資源組名。

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

-RouteTable

與此虛擬中樞相關聯的路由表。

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

-Sku

虛擬中樞的 SKU。

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

-Tag

表示資源標記的哈希表。

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

-VirtualRouterAsn

此虛擬中樞的 ASN

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

-VirtualRouterAutoScaleConfiguration

中樞路由器的自動調整設定

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

-VirtualWan

此中樞所連結的虛擬 wan 物件。

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

-VirtualWanId

此中樞所連結之虛擬 wan 物件的標識碼。

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

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

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

輸入

PSVirtualWan

String

輸出

PSVirtualHub