Set-AzRouteConfig

  • Referentie
Module:
Az.Network

Hiermee werkt u een routeconfiguratie voor een routetabel bij.

Syntax

Set-AzRouteConfig
   -RouteTable <PSRouteTable>
   [-Name <String>]
   [-AddressPrefix <String>]
   [-NextHopType <String>]
   [-NextHopIpAddress <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

De set-AzRouteConfig-cmdlet werkt een routeconfiguratie voor een routetabel bij.

Voorbeelden

Voorbeeld 1: Een route wijzigen

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           : []

Met deze opdracht wordt de routetabel met de naam RouteTable01 opgehaald met behulp van de cmdlet Get-AzRouteTable. De opdracht geeft die tabel door aan de huidige cmdlet met behulp van de pijplijnoperator. De huidige cmdlet wijzigt de route met de naam Route02 en geeft vervolgens het resultaat door aan de cmdlet Set-AzRouteTable , waarmee de tabel wordt bijgewerkt om uw wijzigingen weer te geven.

Voorbeeld 2: Een route wijzigen met behulp van een servicetag (openbare preview)

Set-AzRouteConfig -Name "Route02" -AddressPrefix "AppService" -NextHopType "VirtualAppliance" -NextHopIpAddress "10.0.2.4"

Met deze opdracht wordt de route met de naam Route02 gewijzigd, waarbij een servicetag wordt opgegeven als de parameter AddressPrefix.

Parameters

-AddressPrefix

Hiermee geeft u de bestemming in cidr-indeling (Classless Interdomain Routing) op waarop de route van toepassing is. U kunt hier ook een servicetag opgeven (deze functie is beschikbaar als openbare preview).

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

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Hiermee geeft u de naam van de route die door deze cmdlet wordt gewijzigd.

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

-NextHopIpAddress

Hiermee geeft u het IP-adres op van een virtueel apparaat dat u aan uw virtuele Azure-netwerk toevoegt. Met deze route worden pakketten doorgestuurd naar dat adres. Geef deze parameter alleen op als u een waarde van VirtualAppliance opgeeft voor de parameter NextHopType .

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

-NextHopType

Hiermee geeft u op hoe deze route pakketten doorstuurt. De aanvaardbare waarden voor deze parameter zijn:

  • Internet. De standaardinternetgateway die wordt geleverd door Azure.
  • Geen. Als u deze waarde opgeeft, stuurt de route geen pakketten door.
  • VirtualAppliance. Een virtueel apparaat dat u toevoegt aan uw virtuele Azure-netwerk.
  • VirtualNetworkGateway. Een gateway van een virtueel particulier netwerk van Azureserver naar server.
  • VnetLocal. Het lokale virtuele netwerk. Als u twee subnetten hebt, 10.1.0.0/16 en 10.2.0.0/16 in hetzelfde virtuele netwerk, selecteert u een waarde van VnetLocal voor elk subnet om door te sturen naar het andere subnet.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RouteTable

Hiermee geeft u de routetabel aan waarmee deze route is gekoppeld.

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

PSRouteTable

String

Uitvoerwaarden

PSRouteTable