Condividi tramite

Update-AzVirtualHub

  • Riferimento
Modulo:
Az.Network

Aggiorna un hub virtuale.

Sintassi

Update-AzVirtualHub
      -ResourceGroupName <String>
      -Name <String>
      [-AddressPrefix <String>]
      [-HubVnetConnection <PSHubVirtualNetworkConnection[]>]
      [-RouteTable <PSVirtualHubRouteTable>]
      [-Tag <Hashtable>]
      [-Sku <String>]
      [-PreferredRoutingGateway <String>]
      [-HubRoutingPreference <String>]
      [-VirtualRouterAsn <UInt32>]
      [-VirtualRouterAutoScaleConfiguration <PSVirtualRouterAutoScaleConfiguration>]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzVirtualHub
      -ResourceId <String>
      [-AddressPrefix <String>]
      [-HubVnetConnection <PSHubVirtualNetworkConnection[]>]
      [-RouteTable <PSVirtualHubRouteTable>]
      [-Tag <Hashtable>]
      [-Sku <String>]
      [-PreferredRoutingGateway <String>]
      [-HubRoutingPreference <String>]
      [-VirtualRouterAsn <UInt32>]
      [-VirtualRouterAutoScaleConfiguration <PSVirtualRouterAutoScaleConfiguration>]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzVirtualHub
      -InputObject <PSVirtualHub>
      [-AddressPrefix <String>]
      [-HubVnetConnection <PSHubVirtualNetworkConnection[]>]
      [-RouteTable <PSVirtualHubRouteTable>]
      [-Tag <Hashtable>]
      [-Sku <String>]
      [-PreferredRoutingGateway <String>]
      [-HubRoutingPreference <String>]
      [-VirtualRouterAsn <UInt32>]
      [-VirtualRouterAutoScaleConfiguration <PSVirtualRouterAutoScaleConfiguration>]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Il cmdlet Update-AzVirtualHub aggiorna un hub virtuale.

Esempio

Esempio 1

New-AzResourceGroup -Location "West US" -Name "testRG"
$virtualWan = New-AzVirtualWan -ResourceGroupName "testRG" -Name "myVirtualWAN" -Location "West US"
$virtualHub = New-AzVirtualHub -VirtualWan $virtualWan -ResourceGroupName "testRG" -Name "westushub" -AddressPrefix "10.0.1.0/24"
Update-AzVirtualHub -InputObject $virtualHub -AddressPrefix "10.0.2.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.2.0/24
RouteTable                : 
VirtualNetworkConnections : {}
Location                  : West US
Sku                  : Standard
Type                      : Microsoft.Network/virtualHubs
ProvisioningState         : Succeeded

L'esempio precedente creerà un gruppo di risorse "testRG", una 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 -VirtualWan $virtualWan -ResourceGroupName "testRG" -Name "westushub" -AddressPrefix "10.0.1.0/24"
$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)
Update-AzVirtualHub -ResourceGroupName "testRG" -Name "westushub" -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             : 192.168.2.0/24
RouteTable                : Microsoft.Azure.Commands.Network.Models.PSVirtualHubRouteTable
VirtualNetworkConnections : {}
Location                  : West US
Sku                  : Standard
Type                      : Microsoft.Network/virtualHubs
ProvisioningState         : Succeeded

L'esempio precedente creerà un gruppo di risorse "testRG", una 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 collega anche una tabella di route all'hub virtuale.

Esempio 3

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"
Update-AzVirtualHub -ResourceGroupName "testRG" -Name "westushub" -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

L'esempio precedente creerà un gruppo di risorse "testRG", una rete WAN virtuale e un hub virtuale negli Stati Uniti occidentali in tale gruppo di risorse in Azure. L'hub virtuale avrà inizialmente il gateway di routing preferito come ExpressRoute e verrà quindi aggiornato a VpnGateway.

Parametri

-AddressPrefix

Stringa dello spazio indirizzi per questo hub virtuale.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AsJob

Eseguire il cmdlet in background

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-HubRoutingPreference

Preferenza di routing dell'hub virtuale per instradare il traffico

Tipo:String
Valori accettati:ExpressRoute, VpnGateway, ASPath
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-HubVnetConnection

Connessioni di rete virtuale hub associate a questo hub virtuale.

Tipo:PSHubVirtualNetworkConnection[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Oggetto hub virtuale da modificare.

Tipo:PSVirtualHub
Alias:VirtualHub
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Nome della risorsa.

Tipo:String
Alias:ResourceName, VirtualHubName
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PreferredRoutingGateway

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

Tipo:String
Valori accettati:ExpressRoute, VpnGateway
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ResourceGroupName

Nome del gruppo di risorse.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ResourceId

ID risorsa dell'hub virtuale da modificare.

Tipo:String
Alias:VirtualHubId
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-RouteTable

Tabella di route associata all'hub virtuale.

Tipo:PSVirtualHubRouteTable
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Sku

Sku dell'hub virtuale.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Tag

Tabella hash che rappresenta i tag delle risorse.

Tipo:Hashtable
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-VirtualRouterAsn

AsN di questo hub virtuale

Tipo:UInt32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-VirtualRouterAutoScaleConfiguration

Configurazione della scalabilità automatica per il router hub

Tipo:PSVirtualRouterAutoScaleConfiguration
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

String

PSVirtualHub

Output

PSVirtualHub