New-AzVirtualHub

  • Riferimento
Modulo:
Az.Network

Crea una risorsa VirtualHub di Azure.

Sintassi

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

Descrizione

Crea una risorsa VirtualHub di Azure.

Esempio

Esempio 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

L'esempio precedente creerà un gruppo di risorse "testRG", un rete WAN virtuale e un hub virtuale negli Stati Uniti occidentali in tale gruppo di risorse in Azure. L'hub virtuale avrà lo spazio indirizzi "10.0.1.0/24".

Esempio 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

L'esempio precedente creerà un gruppo di risorse "testRG", un rete WAN virtuale e un hub virtuale negli Stati Uniti occidentali in tale gruppo di risorse in Azure. L'hub virtuale avrà lo spazio indirizzi "10.0.1.0/24".

Questo esempio è simile all'esempio 1, ma usa un ID risorsa per fare riferimento al rete WAN virtuale necessario per creare l'hub virtuale.

Esempio 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

L'esempio precedente creerà un gruppo di risorse "testRG", un rete WAN virtuale e un hub virtuale negli Stati Uniti occidentali in tale gruppo di risorse in Azure. L'hub virtuale avrà lo spazio indirizzi "10.0.1.0/24" e una tabella di route collegata.

Questo esempio è simile all'esempio 2, ma collega anche una tabella di route all'hub virtuale.

Esempio 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

L'esempio precedente creerà un gruppo di risorse "testRG", un rete WAN virtuale e un hub virtuale negli Stati Uniti occidentali in tale gruppo di risorse in Azure. L'hub virtuale avrà il gateway di routing preferito come VPNGateway e la capacità minima 3.

Parametri

-AddressPrefix

Stringa dello spazio indirizzi per questo hub virtuale.

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

-AsJob

Eseguire il cmdlet in background

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

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

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

-HubRoutingPreference

Preferenza di routing dell'hub virtuale per instradare il traffico

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

-HubVnetConnection

Connessioni di rete virtuale hub associate a questo hub virtuale.

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

-Location

posizione.

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

-Name

Nome della risorsa.

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

-PreferredRoutingGateway

Gateway di routing preferito per instradare il traffico locale dalla rete virtuale (deprecato, usare HubRoutingPreference)

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

-ResourceGroupName

Il nome del gruppo di risorse.

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

-RouteTable

Tabella di route associata all'hub virtuale.

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

-Sku

Sku dell'hub virtuale.

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

-Tag

Tabella hash che rappresenta i tag delle risorse.

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

-VirtualRouterAsn

AsN di questo hub virtuale

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

-VirtualRouterAutoScaleConfiguration

Configurazione della scalabilità automatica per il router hub

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

-VirtualWan

L'oggetto wan virtuale a cui è collegato questo hub.

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

-VirtualWanId

L'ID dell'oggetto wan virtuale a cui è collegato questo hub.

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

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Input

PSVirtualWan

String

Output

PSVirtualHub