Set-AzRouteConfig
Atualiza uma configuração de rota para uma tabela de rotas.
Sintaxe
Set-AzRouteConfig
-RouteTable <PSRouteTable>
[-Name <String>]
[-AddressPrefix <String>]
[-NextHopType <String>]
[-NextHopIpAddress <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Set-AzRouteConfig atualiza uma configuração de rota para uma tabela de rotas.
Exemplos
Exemplo 1: Modificar uma rota
Get-AzRouteTable -ResourceGroupName "ResourceGroup11" -Name "RouteTable01" | Set-AzRouteConfig -Name "Route02" -AddressPrefix 10.4.0.0/16 -NextHopType VnetLocal | Set-AzRouteTable
Name : Routetable01
ResourceGroupName : ResourceGroup11
Location : eastus
Id : /subscriptions/xxxx-xxxx-xxxx-xxxx/resourceGroups/ResourceGroup11/providers/Microsoft.Networ
k/routeTables/RouteTable01
Etag : W/"58c2922e-9efe-4554-a457-956ef44bc718"
ProvisioningState : Succeeded
Tags :
Routes : [
{
"Name": "Route07",
"Etag": "W/\"58c2922e-9efe-4554-a457-956ef44bc718\"",
"Id": "/subscriptions/xxxx-xxxx-xxxx-xxxx/resourceGroups/ResourceGroup11/providers/Micro
soft.Network/routeTables/Routetable01/routes/Route07",
"AddressPrefix": "10.1.0.0/16",
"NextHopType": "VnetLocal",
"NextHopIpAddress": null,
"ProvisioningState": "Succeeded"
},
{
"Name": "route02",
"Etag": "W/\"58c2922e-9efe-4554-a457-956ef44bc718\"",
"Id": "/subscriptions/xxxx-xxxx-xxxx-xxxx/resourceGroups/ResourceGroup11/providers/Micro
soft.Network/routeTables/routetable01/routes/route02",
"AddressPrefix": "10.4.0.0/16",
"NextHopType": "VnetLocal",
"NextHopIpAddress": null,
"ProvisioningState": "Succeeded"
}
]
Subnets : []
Este comando obtém a tabela de rotas chamada RouteTable01 usando o cmdlet Get-AzRouteTable. O comando passa essa tabela para o cmdlet atual usando o operador de pipeline. O cmdlet atual modifica a rota chamada Route02 e, em seguida, passa o resultado para o cmdlet Set-AzRouteTable , que atualiza a tabela para refletir suas alterações.
Exemplo 2: Modificar uma rota usando uma etiqueta de serviço (visualização pública)
Set-AzRouteConfig -Name "Route02" -AddressPrefix "AppService" -NextHopType "VirtualAppliance" -NextHopIpAddress "10.0.2.4"
Este comando modifica a rota chamada Route02, fornecendo uma etiqueta de serviço como o parâmetro AddressPrefix.
Parâmetros
-AddressPrefix
Especifica o destino, no formato CIDR (Roteamento entre Domínios sem Classe), ao qual a rota se aplica. Você também pode especificar uma etiqueta de serviço aqui (esse recurso está em Visualização pública).
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.
Tipo: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-Name
Especifica o nome da rota que este cmdlet modifica.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-NextHopIpAddress
Especifica o endereço IP de um dispositivo virtual que você adiciona à sua rede virtual do Azure. Essa rota encaminha pacotes para esse endereço. Especifique esse parâmetro somente se você especificar um valor de VirtualAppliance para o parâmetro NextHopType .
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-NextHopType
Especifica como essa rota encaminha pacotes. Os valores aceitáveis para este parâmetro são:
- Internet. O gateway de Internet padrão fornecido pelo Azure.
- Nenhum. Se você especificar esse valor, a rota não encaminhará pacotes.
- VirtualAppliance. Um dispositivo virtual que você adiciona à sua rede virtual do Azure.
- VirtualNetworkGateway. Um gateway de rede virtual privada Azureserver-to-server.
- VnetLocal. A rede virtual local. Se você tiver duas sub-redes, 10.1.0.0/16 e 10.2.0.0/16 na mesma rede virtual, selecione um valor de VnetLocal para cada sub-rede para encaminhar para a outra sub-rede.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-RouteTable
Especifica a tabela de rotas à qual essa rota está associada.
Tipo: | PSRouteTable |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-WhatIf
Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |