Udostępnij przez

Update-AzVirtualHub

Moduł:
Az.Network Module

Aktualizuje koncentrator wirtualny.

Składnia

ByVirtualHubName (domyślnie) 

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

ByVirtualHubResourceId 

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

ByVirtualHubObject 

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

Opis

Polecenie cmdlet Update-AzVirtualHub aktualizuje koncentrator wirtualny.

Przykłady

Przykład 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

Powyższe polecenie spowoduje utworzenie grupy zasobów "testRG", wirtualnej sieci WAN i koncentratora wirtualnego w regionie Zachodnie stany USA w tej grupie zasobów na platformie Azure. Koncentrator wirtualny będzie miał przestrzeń adresową "10.0.1.0/24".

Przykład 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

Powyższe polecenie spowoduje utworzenie grupy zasobów "testRG", wirtualnej sieci WAN i koncentratora wirtualnego w regionie Zachodnie stany USA w tej grupie zasobów na platformie Azure. Koncentrator wirtualny będzie miał przestrzeń adresową "10.0.1.0/24". Ten przykład jest podobny do przykładu Przykład 1, ale także dołącza tabelę tras do koncentratora wirtualnego.

Przykład 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

Powyższe polecenie spowoduje utworzenie grupy zasobów "testRG", wirtualnej sieci WAN i koncentratora wirtualnego w regionie Zachodnie stany USA w tej grupie zasobów na platformie Azure. Koncentrator wirtualny początkowo będzie miał preferowaną bramę routingu jako usługę ExpressRoute, a następnie zostanie zaktualizowany do bramy VpnGateway.

Parametry

-AddressPrefix

Ciąg przestrzeni adresowej dla tego koncentratora wirtualnego.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-AsJob

Uruchamianie polecenia cmdlet w tle

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:por

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Właściwości parametru

Typ:IAzureContextContainer
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-HubRoutingPreference

Preferencja routingu koncentratora wirtualnego w celu kierowania ruchu

Właściwości parametru

Typ:String
Domyślna wartość:None
Dopuszczalne wartości:ExpressRoute, VpnGateway, ASPath
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-HubVnetConnection

Połączenia sieci wirtualnej koncentratora skojarzone z tym koncentratorem wirtualnym.

Właściwości parametru

Typ:

PSHubVirtualNetworkConnection[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-InputObject

Obiekt koncentratora wirtualnego do zmodyfikowania.

Właściwości parametru

Typ:PSVirtualHub
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:VirtualHub

Zestawy parametrów

ByVirtualHubObject
Position:Named
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Name

Nazwa zasobu.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:NazwaZasobu, VirtualHubName

Zestawy parametrów

ByVirtualHubName
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-PreferredRoutingGateway

Preferowana brama routingu do kierowania ruchu lokalnego z sieci wirtualnej (przestarzała, użyj usługi HubRoutingPreference)

Właściwości parametru

Typ:String
Domyślna wartość:None
Dopuszczalne wartości:ExpressRoute, VpnGateway
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ResourceGroupName

Nazwa grupy zasobów.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

ByVirtualHubName
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ResourceId

Identyfikator zasobu centrum wirtualnego do zmodyfikowania.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Identyfikator VirtualHubId

Zestawy parametrów

ByVirtualHubResourceId
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-RouteTable

Tabela tras skojarzona z tym koncentratorem wirtualnym.

Właściwości parametru

Typ:PSVirtualHubRouteTable
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Sku

Jednostka SKU koncentratora wirtualnego.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Tag

Tabela skrótu reprezentująca tagi zasobów.

Właściwości parametru

Typ:Hashtable
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-VirtualRouterAsn

Nazwa ASN tego koncentratora wirtualnego

Właściwości parametru

Typ:UInt32
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-VirtualRouterAutoScaleConfiguration

Konfiguracja skalowania automatycznego dla routera koncentratora

Właściwości parametru

Typ:PSVirtualRouterAutoScaleConfiguration
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Wi

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

String

PSVirtualHub

Dane wyjściowe

PSVirtualHub