Add-AzRouteConfig

  • Référence
Module:
Az.Network

Ajoute un itinéraire à une table de routage.

Syntax

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

Description

L’applet de commande Add-AzRouteConfig ajoute un itinéraire à une table de routage Azure.

Exemples

Exemple 1 : Ajouter un itinéraire à une table de routage

$RouteTable = Get-AzRouteTable -ResourceGroupName "ResourceGroup11" -Name "RouteTable01"
Add-AzRouteConfig -Name "Route13" -AddressPrefix 10.3.0.0/16 -NextHopType "VnetLocal" -RouteTable $RouteTable

La première commande obtient une table de routage nommée RouteTable01 à l’aide de l’applet de commande Get-AzRouteTable. La commande stocke la table dans la variable $RouteTable. La deuxième commande ajoute un itinéraire nommé Route13 à la table de routage stockée dans $RouteTable. Cet itinéraire transfère les paquets au réseau virtuel local.

Exemple 2 : Ajouter un itinéraire à une table de routage à l’aide du pipeline

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           : []

Cette commande obtient la table de routage nommée RouteTable01 à l’aide de Get-AzRouteTable. La commande transmet cette table à l’applet de commande actuelle à l’aide de l’opérateur de pipeline. L’applet de commande actuelle ajoute l’itinéraire nommé Route02, puis transmet le résultat à l’applet de commande Set-AzRouteTable , qui met à jour la table pour refléter vos modifications.

Exemple 3 : Ajouter un itinéraire avec une balise de service à une table de routage (préversion publique)

$RouteTable = Get-AzRouteTable -ResourceGroupName "ResourceGroup11" -Name "RouteTable01"
Add-AzRouteConfig -Name "Route13" -AddressPrefix "AppService" -NextHopType "VirtualAppliance" -NextHopIpAddress "10.0.2.4" -RouteTable $RouteTable

La première commande obtient une table de routage nommée RouteTable01 à l’aide de l’applet de commande Get-AzRouteTable. La commande stocke la table dans la variable $RouteTable. La deuxième commande ajoute un itinéraire nommé Route13 à la table de routage stockée dans $RouteTable. Cet itinéraire transfère le trafic vers les préfixes IP contenus dans la balise AppService Service vers une appliance virtuelle.

Paramètres

-AddressPrefix

Spécifie la destination, au format CIDR (routage CIDR (Classless InterDomain Routing)), à laquelle l’itinéraire s’applique. Vous pouvez également spécifier une balise de service ici (cette fonctionnalité est disponible en préversion publique).

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

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

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

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

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

-Name

Spécifie un nom de l’itinéraire à ajouter à la table de routage.

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

-NextHopIpAddress

Spécifie l’adresse IP d’une appliance virtuelle que vous ajoutez à votre réseau virtuel Azure. Cet itinéraire transfère les paquets à cette adresse. Spécifiez ce paramètre uniquement si vous spécifiez une valeur de VirtualAppliance pour le paramètre NextHopType .

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

-NextHopType

Spécifie la façon dont cet itinéraire transfère les paquets. Les valeurs valides pour ce paramètre sont :

  • Internet. Passerelle Internet par défaut fournie par Azure.
  • Aucune. Si vous spécifiez cette valeur, l’itinéraire ne transfère pas les paquets.
  • VirtualAppliance. Appliance virtuelle que vous ajoutez à votre réseau virtuel Azure.
  • VirtualNetworkGateway. Passerelle de réseau privé virtuel de serveur à serveur Azure.
  • VnetLocal. Réseau virtuel local. Si vous avez deux sous-réseaux, 10.1.0.0/16 et 10.2.0.0/16 dans le même réseau virtuel, sélectionnez une valeur de VnetLocal pour chaque sous-réseau à transférer vers l’autre sous-réseau.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RouteTable

Spécifie la table de routage à laquelle cette applet de commande ajoute un itinéraire.

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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

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

Entrées

PSRouteTable

String

Sorties

PSRouteTable