Irakurri ingelesez

Partekatu honen bidez:

Add-AzRouteConfig

  • Referencia
Módulo:
Az.Network

Agrega una ruta a una tabla de rutas.

Sintaxis

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

Description

El cmdlet Add-AzRouteConfig agrega una ruta a una tabla de rutas de Azure.

Ejemplos

Ejemplo 1: Agregar una ruta a una tabla de rutas

PowerShell 
PS C:\>$RouteTable = Get-AzRouteTable -ResourceGroupName "ResourceGroup11" -Name "RouteTable01"
PS C:\> Add-AzRouteConfig -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-AzRouteTable. 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

PowerShell 
PS C:\>Get-AzRouteTable -ResourceGroupName "ResourceGroup11" -Name "RouteTable01" | Add-AzRouteConfig -Name "Route02" -AddressPrefix 10.2.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/"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-AzRouteTable. 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-AzRouteTable , 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
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Confirm

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

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

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifica un nombre de la ruta que se va a agregar a la tabla de rutas.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-RouteTable

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

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

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

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

Entradas

PSRouteTable

El parámetro 'RouteTable' acepta el valor del tipo "PSRouteTable" de la canalización.

Salidas

PSRouteTable