New-AzVHubRoute
Cria um objeto VHubRoute que pode ser passado como parâmetro para o comando New-AzVHubRouteTable.
Sintaxe
Default (Predefinição)
New-AzVHubRoute
-Destination <String[]>
-DestinationType <String>
-NextHop <String>
-Name <String>
-NextHopType <String>
[-DefaultProfile <IAzureContextContainer>]
[-AcquirePolicyToken]
[-ChangeReference <String>]
[<CommonParameters>]
Descrição
Cria um objeto VHubRoute.
Exemplos
Exemplo 1
$rgName = "testRg"
$firewallName = "testFirewall"
$firewall = Get-AzFirewall -Name $firewallName -ResourceGroupName $rgName
New-AzVHubRoute -Name "private-traffic" -Destination @("10.30.0.0/16", "10.40.0.0/16") -DestinationType "CIDR" -NextHop $firewall.Id -NextHopType "ResourceId"
Name : private-traffic
DestinationType : CIDR
Destinations : {10.30.0.0/16, 10.40.0.0/16}
NextHopType : ResourceId
NextHop : /subscriptions/testSub/resourceGroups/testRg/providers/Microsoft.Network/azureFirewalls/testFirewall
O comando acima criará um objeto VHubRoute com nextHop como o Firewall especificado que pode ser adicionado a um recurso VHubRouteTable.
Exemplo 2
$rgName = "testRg"
$hubName = "testHub"
$hubVnetConnName = "testHubVnetConn"
$hubVnetConnection = Get-AzVirtualHubVnetConnection -Name $hubVnetConnName -ParentResourceName $hubName -ResourceGroupName $rgName
New-AzVHubRoute -Name "nva-traffic" -Destination @("10.20.0.0/16", "10.50.0.0/16") -DestinationType "CIDR" -NextHop $hubVnetConnection.Id -NextHopType "ResourceId"
Name : private-traffic
DestinationType : CIDR
Destinations : {10.30.0.0/16, 10.40.0.0/16}
NextHopType : ResourceId
NextHop : /subscriptions/testSub/resourceGroups/testRg/providers/Microsoft.Network/virtualHubs/testHub/hubVirtualNetworkConnections/testHubVnetConn
O comando acima criará um objeto VHubRoute com nextHop como o hubVnetConnection especificado, que pode ser adicionado a um recurso VHubRouteTable.
Exemplo 3
$hub = Get-AzVirtualHub -ResourceGroupName "rgname" -Name "virtual-hub-name"
$hubVnetConn = Get-AzVirtualHubVnetConnection -ParentObject $hub -Name "connection-name"
$hubVnetConn
Name : conn_2
Id : /subscriptions/{subscriptionID}/resourceGroups/{rgname}/providers/Microsoft.Network/virtualHubs/{virtual-hub-name}/hubVirtualNetworkConnections/conn_2
RemoteVirtualNetwork : /subscriptions/{subscriptionID}/resourceGroups/{rgname}/providers/Microsoft.Network/virtualNetworks/rVnet_2
EnableInternetSecurity : True
ProvisioningState : Succeeded
RoutingConfiguration : {
"AssociatedRouteTable": {
"Id": "/subscriptions/{subscriptionID}/resourceGroups/{rgname}/providers/Microsoft.Network/virtualHubs/{virtual-hub-name}/hubRouteTables/defaultRouteTable"
},
"PropagatedRouteTables": {
"Labels": [
"default"
],
"Ids": [
{
"Id":
"/subscriptions/{subscriptionID}/resourceGroups/{rgname}/providers/Microsoft.Network/virtualHubs/{virtual-hub-name}/hubRouteTables/defaultRouteTable"
}
]
},
"VnetRoutes": {
"StaticRoutes": []
}
}
$staticRoute1 = New-AzStaticRoute -Name "static_route1" -AddressPrefix @("10.2.1.0/24", "10.2.3.0/24") -NextHopIpAddress "10.2.0.5"
$routingConfig = $hubVnetConn.RoutingConfiguration
$routingConfig.VnetRoutes.StaticRoutes = @($staticRoute1)
$routingConfig
AssociatedRouteTable : Microsoft.Azure.Commands.Network.Models.PSResourceId
PropagatedRouteTables : {
"Labels": [
"default"
],
"Ids": [
{
"Id":
"/subscriptions/{subscriptionID}/resourceGroups/{rgname}/providers/Microsoft.Network/virtualHubs/rTestHub1/hubRouteTables/defaultRouteTable"
}
]
}
VnetRoutes : {
"StaticRoutes": [
{
"Name": "static_route1",
"AddressPrefixes": [
"10.2.1.0/24",
"10.2.3.0/24"
],
"NextHopIpAddress": "10.2.0.5"
}
]
}
Update-AzVirtualHubVnetConnection -InputObject $hubVnetConn -RoutingConfiguration $routingConfig
Os comandos acima obterão a RoutingConfiguration de um AzVHubRoute já existente e, em seguida, adicionarão uma rota estática na conexão. Alternativamente, se você espera criar uma nova conexão com a rota estática dentro dela, consulte o Exemplo 1 aqui.
Parâmetros
-AcquirePolicyToken
Adquira automaticamente um token Azure Policy para esta operação de recurso.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-ChangeReference
A alteração do ID de referência do recurso para esta operação de recurso.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-DefaultProfile
As credenciais, conta, inquilino e subscrição usados para comunicação com o Azure.
Propriedades dos parâmetros
Tipo: IAzureContextContainer
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Aliases: AzContext, AzureRmContext, AzureCredential
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-Destination
Lista de destinos.
Propriedades dos parâmetros
Tipo: String [ ]
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-DestinationType
Tipo de destinos.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-Name
O nome da rota.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-NextHop
O próximo salto.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-NextHopType
O tipo Next Hop.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters .
Saídas