Set-AzRouteConfig

Module:
Az.Network Module

Hiermee werkt u een routeconfiguratie voor een routetabel bij.

Syntax

Default (Standaard) 

Set-AzRouteConfig
    -RouteTable <PSRouteTable>
    [-Name <String>]
    [-AddressPrefix <String>]
    [-NextHopType <String>]
    [-NextHopIpAddress <String[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<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

-AcquirePolicyToken

Een Azure Policy token automatisch verkrijgen voor deze resourcebewerking.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-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).

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-ChangeReference

De wijzigingsresource-id voor deze resourcebewerking.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DefaultProfile

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

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzContext, AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Name

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-NextHopIpAddress

Hiermee geeft u het IP-adres(en) van de volgende hop waarnaar deze route pakketten doorstuurt. Geef voor een NextHopType van VirtualAppliance één IP-adres op van een virtueel apparaat dat u aan uw Azure virtueel netwerk toevoegt. Voor een NextHopType van VirtualApplianceEcmp levert u tussen 2 en 64 IP-adressen om verkeer over gelijke kosten te verdelen via ECMP-routering (equal-cost multi-path).

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-NextHopType

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

  • Internet. De standaardinternetgateway die wordt geleverd door Azure.
  • None. Als u deze waarde opgeeft, stuurt de route geen pakketten door.
  • VirtualAppliance. Een virtueel apparaat dat u aan uw Azure virtueel netwerk toevoegt.
  • VirtualApplianceEcmp. Meerdere virtuele apparaten die verkeer gelijkmatig verdelen over het gebruik van ECMP-routering (equal-cost multi-path). Geef de IP-adressen van het apparaat op via de parameter NextHopIpAddress .
  • 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.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-RouteTable

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

Parametereigenschappen

Type:PSRouteTable
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

PSRouteTable

String

Uitvoerwaarden

PSRouteTable