Add-AzureRmRouteConfig
Agrega una ruta a una tabla de rutas.
Advertencia
El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.
Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.
Syntax
Add-AzureRmRouteConfig
-RouteTable <PSRouteTable>
[-Name <String>]
[-AddressPrefix <String>]
[-NextHopType <String>]
[-NextHopIpAddress <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
El cmdlet Add-AzureRmRouteConfig agrega una ruta a una tabla de rutas de Azure.
Ejemplos
Ejemplo 1: Agregar una ruta a una tabla de rutas
PS C:\>$RouteTable = Get-AzureRmRouteTable -ResourceGroupName "ResourceGroup11" -Name "RouteTable01"
PS C:\> Add-AzureRmRouteConfig -Name "Route13" -AddressPrefix 10.3.0.0/16 -NextHopType "VnetLocal" -RouteTable $RouteTable
El primer comando obtiene una tabla de rutas denominada RouteTable01 mediante el cmdlet Get-AzureRmRouteTable. El comando almacena la tabla en la variable $RouteTable. El segundo comando agrega una ruta denominada Route13 a la tabla de rutas almacenada en $RouteTable. Esta ruta reenvía los paquetes a la red virtual local.
Ejemplo 2: Adición de una ruta a una tabla de rutas mediante la canalización
PS C:\>Get-AzureRmRouteTable -ResourceGroupName "ResourceGroup11" -Name "RouteTable01" | Add-AzureRmRouteConfig -Name "Route02" -AddressPrefix 10.2.0.0/16 -NextHopType VnetLocal | Set-AzureRmRouteTable
Name : routetable01
ResourceGroupName : ResourceGroup11
Location : eastus
Id : /subscriptions/xxxx-xxxx-xxxx-xxxx/resourceGroups/ResourceGroup11/providers/Microsoft.Networ
k/routeTables/routetable01
Etag : W/"f13e1bc8-d41f-44d0-882d-b8b5a1134f59"
ProvisioningState : Succeeded
Tags :
Routes : [
{
"Name": "route07",
"Etag": "W/\"f13e1bc8-d41f-44d0-882d-b8b5a1134f59\"",
"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/\"f13e1bc8-d41f-44d0-882d-b8b5a1134f59\"",
"Id": "/subscriptions/xxxx-xxxx-xxxx-xxxx/resourceGroups/ResourceGroup11/providers/Micro
soft.Network/routeTables/routetable01/routes/route02",
"AddressPrefix": "10.2.0.0/16",
"NextHopType": "VnetLocal",
"NextHopIpAddress": null,
"ProvisioningState": "Succeeded"
},
{
"Name": "route13",
"Etag": null,
"Id": null,
"AddressPrefix": "10.3.0.0/16",
"NextHopType": "VnetLocal",
"NextHopIpAddress": null,
"ProvisioningState": null
}
]
Subnets : []
Este comando obtiene la tabla de rutas denominada RouteTable01 mediante Get-AzureRmRouteTable. El comando pasa esa tabla al cmdlet actual mediante el operador de canalización. El cmdlet actual agrega la ruta denominada Route02 y, a continuación, pasa el resultado al cmdlet Set-AzureRmRouteTable , que actualiza la tabla para reflejar los cambios.
Parámetros
-AddressPrefix
Especifica el destino, en formato Enrutamiento de interdominios sin clases (CIDR), al que se aplica la ruta.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.
Tipo: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifica un nombre de la ruta que se va a agregar a la tabla de rutas.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NextHopIpAddress
Especifica la dirección IP de una aplicación virtual que se agrega a la red virtual de Azure. Esta ruta reenvía los paquetes a esa dirección. Especifique este parámetro solo si especifica un valor de VirtualAppliance para el parámetro NextHopType .
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NextHopType
Especifica cómo esta ruta reenvía los paquetes. Los valores permitidos para este parámetro son los siguientes:
- Internet. Puerta de enlace de Internet predeterminada proporcionada por Azure.
- Ninguno. Si especifica este valor, la ruta no reenvía paquetes.
- VirtualAppliance. Una aplicación virtual que agregue a la red virtual de Azure.
- VirtualNetworkGateway. Una puerta de enlace de red privada virtual de servidor a servidor de Azure.
- VnetLocal. Red virtual local. Si tiene dos subredes, 10.1.0.0/16 y 10.2.0.0/16 en la misma red virtual, seleccione un valor de VnetLocal para cada subred para reenviar a la otra subred.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RouteTable
Especifica la tabla de rutas a la que este cmdlet agrega una ruta.
Tipo: | PSRouteTable |
Position: | Named |
valor predeterminado: | None |
Requerido: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
Tipo: | SwitchParameter |
Aliases: | wi |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |