Compartir a través de

Set-AzureRoute

  • Referencia
Módulo:
Azure

Crea una ruta en una tabla de rutas.

Nota:

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan las API de Azure Service Management (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.

El módulo Az de PowerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

Sintaxis

Set-AzureRoute
   -RouteName <String>
   -AddressPrefix <String>
   -NextHopType <String>
   [-NextHopIpAddress <String>]
   -RouteTable <IRouteTable>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

El cmdlet Set-AzureRoute crea una ruta en una tabla de rutas. La nueva ruta surte efecto casi inmediatamente en las máquinas virtuales asociadas a la tabla de rutas.

Ejemplos

Ejemplo 1: Adición de una ruta del próximo salto de una aplicación virtual

PS C:\> New-AzureRouteTable -Name "ApplianceRouteTable" -Location "Central US" -Label "Appliance Route Table" | Set-AzureRoute -RouteName "ApplianceRoute03" -AddressPrefix "10.0.0.0/24" -NextHopType VirtualAppliance -NextHopIpAddress "10.0.1.5"

Routes                        Name                          Location                      Label
------                        ----                          --------                      -----
{approute}                    AppRT                         Central US                    Appliance Route Table

Este comando crea una tabla de rutas denominada ApplianceRouteTable en la ubicación especificada. El comando pasa esa tabla de rutas al cmdlet actual. El cmdlet actual agrega una ruta denominada ApplianceRoute03, que es un tipo de próximo salto de VirtualAppliance. El comando especifica la dirección IP del próximo salto y el prefijo de dirección de la ruta.

Ejemplo 2: Agregar una ruta de próximo salto de Internet

PS C:\> Get-AzureRouteTable -Name "ApplianceRouteTable" | Set-AzureRoute -RouteName "InternetRoute" -AddressPrefix "0.0.0.0/0" -NextHopType Internet

Routes                        Name                          Location                      Label
------                        ----                          --------                      -----
{approute, internetroute}     AppRT                         Central US                    Appliance Route Table

Este comando obtiene una tabla de rutas denominada ApplianceRouteTable. El comando pasa esa tabla de rutas al cmdlet actual. El cmdlet actual agrega una ruta denominada InternetRoute, que es un tipo de próximo salto de Internet. El comando especifica el prefijo de dirección para la ruta.

Parámetros

-AddressPrefix

Especifica un prefijo de dirección para la nueva ruta.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-NextHopIpAddress

Especifica la dirección IP del dispositivo que es el próximo salto para el tráfico que usa esta ruta. Especifique este valor solo si especifica un valor de VirtualAppliance para el parámetro NextHopType .

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-NextHopType

Especifica el tipo de próximo salto para el tráfico que usa esta ruta. Los valores válidos son:

  • VPNGateway
  • VNETLocal
  • Internet
  • VirtualAppliance
  • Null
Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Profile

Especifica el perfil de Azure del que lee este cmdlet. Si no especifica un perfil, este cmdlet lee del perfil predeterminado local.

Tipo:AzureSMProfile
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RouteName

Especifica un nombre para la nueva ruta que agrega este cmdlet.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RouteTable

Especifica la tabla de rutas a la que este cmdlet agrega la nueva ruta.

Tipo:IRouteTable
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False