Set-AzRouteConfig

  • Referencia
Módulo:
Az.Network

Novedades una configuración de ruta para una tabla de rutas.

Syntax

Set-AzRouteConfig
   -RouteTable <PSRouteTable>
   [-Name <String>]
   [-AddressPrefix <String>]
   [-NextHopType <String>]
   [-NextHopIpAddress <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Set-AzRouteConfig actualiza una configuración de ruta para una tabla de rutas.

Ejemplos

Ejemplo 1: Modificar una ruta

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 obtiene la tabla de rutas denominada RouteTable01 mediante el cmdlet Get-AzRouteTable. El comando pasa esa tabla al cmdlet actual mediante el operador de canalización. El cmdlet actual modifica la ruta denominada Route02 y, a continuación, pasa el resultado al cmdlet Set-AzRouteTable , que actualiza la tabla para reflejar los cambios.

Ejemplo 2: Modificación de una ruta mediante una etiqueta de servicio (versión preliminar pública)

Set-AzRouteConfig -Name "Route02" -AddressPrefix "AppService" -NextHopType "VirtualAppliance" -NextHopIpAddress "10.0.2.4"

Este comando modifica la ruta denominada Route02, proporcionando una etiqueta de servicio como el parámetro AddressPrefix.

Parámetros

-AddressPrefix

Especifica el destino, en formato Enrutamiento de interdominios sin clases (CIDR), al que se aplica la ruta. También puede especificar una etiqueta de servicio aquí (esta característica está en versión preliminar pública).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required: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.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica el nombre de la ruta que modifica este cmdlet.

Type:String
Position:Named
Default value:None
Required: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 .

Type:String
Position:Named
Default value:None
Required: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.
  • 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.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RouteTable

Especifica la tabla de rutas con la que está asociada esta ruta.

Type:PSRouteTable
Position:Named
Default value:None
Required: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.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

PSRouteTable

String

Salidas

PSRouteTable