Add-AzRouteConfig
Ajoute un itinéraire à une table de routage.
Syntaxe
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 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
Type: | SwitchParameter |
Alias: | cf |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
Type: | IAzureContextContainer |
Alias: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Name
Spécifie un nom de l’itinéraire à ajouter à la table de routage.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | 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 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | 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 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-RouteTable
Spécifie la table de routage à laquelle cette applet de commande ajoute un itinéraire.
Type: | PSRouteTable |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | 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 |
Alias: | wi |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
Entrées
Sorties
Liens associés
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour