Set-AzureRoute

Référence

Module:: Azure

Crée un itinéraire dans une table de routage.

Notes

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Gestion des services. Pour ce qui est des cmdlets permettant de gérer des ressources Azure Resource Manager, consultez le Module Az PowerShell.

Syntax

Set-AzureRoute
   -RouteName <String>
   -AddressPrefix <String>
   -NextHopType <String>
   [-NextHopIpAddress <String>]
   -RouteTable <IRouteTable>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

L’applet de commande Set-AzureRoute crée un itinéraire dans une table de routage. La nouvelle route prend effet presque immédiatement sur les machines virtuelles associées à la table de routage.

Exemples

Exemple 1 : Ajouter un itinéraire de tronçon suivant de l’appliance virtuelle

PS C:\> New-AzureRouteTable -Name "ApplianceRouteTable" -Location "Central US" -Label "Appliance Route Table" | Set-AzureRoute -RouteName "ApplianceRoute03" -AddressPrefix "10.0.0.0/24" -NextHopType VirtualAppliance -NextHopIpAddress "10.0.1.5"

Routes                        Name                          Location                      Label
------                        ----                          --------                      -----
{approute}                    AppRT                         Central US                    Appliance Route Table

Cette commande crée une table de routage nommée ApplianceRouteTable à l’emplacement spécifié. La commande transmet cette table de routage à l’applet de commande actuelle. L’applet de commande actuelle ajoute un itinéraire nommé ApplianceRoute03, qui est un type de tronçon suivant VirtualAppliance. La commande spécifie l’adresse IP du tronçon suivant et le préfixe d’adresse de l’itinéraire.

Exemple 2 : Ajouter un itinéraire de tronçon suivant Internet

PS C:\> Get-AzureRouteTable -Name "ApplianceRouteTable" | Set-AzureRoute -RouteName "InternetRoute" -AddressPrefix "0.0.0.0/0" -NextHopType Internet

Routes                        Name                          Location                      Label
------                        ----                          --------                      -----
{approute, internetroute}     AppRT                         Central US                    Appliance Route Table

Cette commande obtient une table de routage nommée ApplianceRouteTable. La commande transmet cette table de routage à l’applet de commande actuelle. L’applet de commande actuelle ajoute un itinéraire nommé InternetRoute, qui est un type de tronçon suivant Internet. La commande spécifie le préfixe d’adresse de l’itinéraire.

Paramètres

-AddressPrefix

Spécifie un préfixe d’adresse pour le nouvel itinéraire.

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

-NextHopIpAddress

Spécifie l’adresse IP de l’appliance qui est le tronçon suivant pour le trafic qui utilise cet itinéraire. Spécifiez cette valeur 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:	False
Accept wildcard characters:	False

-NextHopType

Spécifie le type de tronçon suivant pour le trafic qui utilise cet itinéraire. Les valeurs autorisées sont :

VPNGateway
VNETLocal
Internet
VirtualAppliance
Null

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

-Profile

Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.

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

-RouteName

Spécifie un nom pour la nouvelle route que cette applet de commande ajoute.

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

-RouteTable

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

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

Remove-AzureRoute