Set-AzRouteConfig
Met à jour une configuration de routage pour une table de routage.
Syntaxe
Set-AzRouteConfig
-RouteTable <PSRouteTable>
[-Name <String>]
[-AddressPrefix <String>]
[-NextHopType <String>]
[-NextHopIpAddress <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
L’applet de commande Set-AzRouteConfig met à jour une configuration de routage pour une table de routage.
Exemples
Exemple 1 : Modifier un itinéraire
Get-AzRouteTable -ResourceGroupName "ResourceGroup11" -Name "RouteTable01" | Set-AzRouteConfig -Name "Route02" -AddressPrefix 10.4.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/"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-AzRouteTable. 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-AzRouteTable , qui met à jour la table pour refléter vos modifications.
Exemple 2 : Modifier un itinéraire à l’aide d’une balise de service (préversion publique)
Set-AzRouteConfig -Name "Route02" -AddressPrefix "AppService" -NextHopType "VirtualAppliance" -NextHopIpAddress "10.0.2.4"Cette commande modifie l’itinéraire nommé Route02, en fournissant une balise de service comme paramètre AddressPrefix.
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 le nom de l’itinéraire modifié par cette applet de commande.
| 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 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 |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | 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 |
| 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 |
