Set-AzureRmRouteConfig
Définit l’état d’objectif d’un itinéraire.
Avertissement
Le module AzureRM PowerShell a été officiellement déconseillé depuis 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.
Bien que le module AzureRM puisse toujours fonctionner, il n’est plus conservé ou pris en charge, plaçant toute utilisation continue à la discrétion et au risque de l’utilisateur. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.
Syntax
Set-AzureRmRouteConfig
-RouteTable <PSRouteTable>
[-Name <String>]
[-AddressPrefix <String>]
[-NextHopType <String>]
[-NextHopIpAddress <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
L’applet de commande Set-AzureRmRouteConfig définit l’état d’objectif d’un itinéraire Azure.
Exemples
Exemple 1 : Modifier un itinéraire
PS C:\>Get-AzureRmRouteTable -ResourceGroupName "ResourceGroup11" -Name "RouteTable01" | Set-AzureRmRouteConfig -Name "Route02" -AddressPrefix 10.4.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/"58c2922e-9efe-4554-a457-956ef44bc718"
ProvisioningState : Succeeded
Tags :
Routes : [
{
"Name": "Route07",
"Etag": "W/\"58c2922e-9efe-4554-a457-956ef44bc718\"",
"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/\"58c2922e-9efe-4554-a457-956ef44bc718\"",
"Id": "/subscriptions/xxxx-xxxx-xxxx-xxxx/resourceGroups/ResourceGroup11/providers/Micro
soft.Network/routeTables/routetable01/routes/route02",
"AddressPrefix": "10.4.0.0/16",
"NextHopType": "VnetLocal",
"NextHopIpAddress": null,
"ProvisioningState": "Succeeded"
}
]
Subnets : []Cette commande obtient la table de routage nommée RouteTable01 à l’aide de l’applet de commande 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 modifie 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 |
| 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 |
| valeur par défaut: | None |
| Obligatoire: | 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: | AzureRmContext, AzureCredential |
| Position: | Named |
| valeur par défaut: | None |
| Obligatoire: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Spécifie le nom de l’itinéraire modifié par cette applet de commande.
| Type: | String |
| Position: | Named |
| valeur par défaut: | None |
| Obligatoire: | 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 |
| valeur par défaut: | None |
| Obligatoire: | 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 azureserver-à-serveur.
- 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 |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-RouteTable
Spécifie la table de routage avec laquelle cet itinéraire est associé.
| Type: | PSRouteTable |
| Position: | Named |
| valeur par défaut: | None |
| Obligatoire: | 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 |
| valeur par défaut: | None |
| Obligatoire: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |