Add-AzureRmRouteConfig
Ajoute un itinéraire à une table de routage.
Avertissement
Le module AzureRM PowerShell a été officiellement déprécié le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.
Il est possible que le module AzureRM fonctionne encore, mais il ne fait plus l’objet de maintenance ni de support. L’utilisateur peut continuer à s’en servir s’il le souhaite, à ses propres risques. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.
Syntaxe
Add-AzureRmRouteConfig
-RouteTable <PSRouteTable>
[-Name <String>]
[-AddressPrefix <String>]
[-NextHopType <String>]
[-NextHopIpAddress <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Add-AzureRmRouteConfig ajoute un itinéraire à une table de routage Azure.
Exemples
Exemple 1 : Ajouter un itinéraire à une table de routage
PS C:\>$RouteTable = Get-AzureRmRouteTable -ResourceGroupName "ResourceGroup11" -Name "RouteTable01"
PS C:\> Add-AzureRmRouteConfig -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-AzureRmRouteTable. 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
PS C:\>Get-AzureRmRouteTable -ResourceGroupName "ResourceGroup11" -Name "RouteTable01" | Add-AzureRmRouteConfig -Name "Route02" -AddressPrefix 10.2.0.0/16 -NextHopType VnetLocal | Set-AzureRmRouteTable
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-AzureRmRouteTable. 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-AzureRmRouteTable , qui met à jour la table pour refléter vos modifications.
Paramètres
-AddressPrefix
Spécifie la destination, au format CIDR (routage CIDR (Classless InterDomain Routing)), à laquelle l’itinéraire s’applique.
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: | 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 |