Partager via

Set-AzExpressRouteGateway

Module:
Az.Network Module

Met à jour une passerelle ExpressRoute scalable.

Syntaxe

ByExpressRouteGatewayName (Par défaut) 

Set-AzExpressRouteGateway
    -ResourceGroupName <String>
    -Name <String>
    [-MinScaleUnits <UInt32>]
    [-MaxScaleUnits <UInt32>]
    [-AllowNonVirtualWanTraffic <Boolean>]
    [-Tag <Hashtable>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByExpressRouteGatewayObject 

Set-AzExpressRouteGateway
    -InputObject <PSExpressRouteGateway>
    [-MinScaleUnits <UInt32>]
    [-MaxScaleUnits <UInt32>]
    [-AllowNonVirtualWanTraffic <Boolean>]
    [-Tag <Hashtable>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByExpressRouteGatewayResourceId 

Set-AzExpressRouteGateway
    -ResourceId <String>
    [-MinScaleUnits <UInt32>]
    [-MaxScaleUnits <UInt32>]
    [-AllowNonVirtualWanTraffic <Boolean>]
    [-Tag <Hashtable>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

L’applet de commande Set-AzExpressRouteGateway vous permet de mettre à jour les unités d’échelle pour un ExpressRouteGateway existant ou de mettre à jour les balises de ressource.

Exemples

Exemple 1

New-AzResourceGroup -Location "West US" -Name "testRG"
$virtualWan = New-AzVirtualWan -ResourceGroupName testRG -Name myVirtualWAN -Location "West US"
$virtualHub = New-AzVirtualHub -VirtualWan $virtualWan -ResourceGroupName "testRG" -Name "westushub" -AddressPrefix "10.0.0.1/24"
New-AzExpressRouteGateway -ResourceGroupName "testRG" -Name "testergw" -VirtualHubId $virtualHub.Id -MinScaleUnits 2
Set-AzExpressRouteGateway -ResourceGroupName "testRG" -Name "testergw" -MinScaleUnits 3

ResourceGroupName   : testRG
Name                : testergw
Id                  : /subscriptions/{subscriptionId}/resourceGroups/testRG/providers/Microsoft.Network/expressRouteGateways/testergw
Location            : West US
MinScaleUnits       : 3
Type                : Microsoft.Network/expressRouteGateways
ProvisioningState   : Succeeded

La section ci-dessus crée un groupe de ressources « testRG », un réseau étendu virtuel et un hub virtuel dans la région USA Ouest dans ce groupe de ressources dans Azure. Une passerelle ExpressRoute sera créée par la suite dans le hub virtuel avec 2 unités d’échelle qui seront ensuite modifiées en 3 unités d’échelle.

Exemple 2 : Configurez cette passerelle pour accepter le trafic à partir de réseaux non Virtual Wan.

Vous pouvez récupérer la passerelle, configurer sa propriété AllowNonVirtualWanTraffic et enregistrer les modifications sur la passerelle ou simplement utiliser le commutateur sur l’applet de commande Set-AzExpressRouteGateway

# Option 1 - Retrieve the gateway object, configure it to allow traffic from VNets and persist those changes.
$gateway = Get-AzExpressRouteGateway -ResourceGroupName "resourceGroup001" -Name "gateway001"
$gateway.AllowNonVirtualWanTraffic = $true
$gateway = Set-AzExpressRouteGateway -InputObject $gateway

# Option 2 - Use the cmdlet switch
Set-AzExpressRouteGateway -ResourceGroupName "resourceGroup001" -Name "gateway001" -AllowNonVirtualWanTraffic $true

Exemple 3 : Configurez cette passerelle pour bloquer le trafic à partir de réseaux non Virtual Wan.

Vous pouvez récupérer la passerelle, configurer sa propriété AllowNonVirtualWanTraffic et enregistrer les modifications sur la passerelle ou simplement utiliser le commutateur sur l’applet de commande Set-AzExpressRouteGateway

# Option 1 - Retrieve the gateway object, configure it to block traffic from VNets and persist those changes.
$gateway=Get-AzExpressRouteGateway -ResourceGroupName "resourceGroup001" -Name "gateway001"
$gateway.AllowNonVirtualWanTraffic = $false
$gateway = Set-AzExpressRouteGateway -InputObject $gateway

# Option 2 - Use the cmdlet switch
Set-AzExpressRouteGateway -ResourceGroupName "resourceGroup001" -Name "gateway001" -AllowNonVirtualWanTraffic $false

Paramètres

-AllowNonVirtualWanTraffic

Détermine si cette passerelle doit accepter le trafic à partir d’autres réseaux virtuels

Propriétés du paramètre

Type:

Nullable<T>[Boolean]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-AsJob

Exécuter l’applet de commande en arrière-plan

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-InputObject

ExpressRouteGateway qui doit être mis à jour.

Propriétés du paramètre

Type:PSExpressRouteGateway
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:ExpressRouteGateway

Jeux de paramètres

ByExpressRouteGatewayObject
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-MaxScaleUnits

Nombre maximal d’unités d’échelle pour cet ExpressRouteGateway. Plage > valide 2

Propriétés du paramètre

Type:UInt32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-MinScaleUnits

Nombre minimal d’unités d’échelle pour cet ExpressRouteGateway. Plage > valide 2

Propriétés du paramètre

Type:UInt32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Name

Nom de la ressource.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:ResourceName, ExpressRouteGatewayName, Nom de la passerelle

Jeux de paramètres

ByExpressRouteGatewayName
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ResourceGroupName

Nom du groupe de ressources d’ExpressRouteGateway à mettre à jour.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ByExpressRouteGatewayName
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ResourceId

ID de ExpressRouteGateway qui doit être mis à jour.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ByExpressRouteGatewayResourceId
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Tag

Table de hachage qui représente les balises de ressource.

Propriétés du paramètre

Type:Hashtable
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

PSVirtualHub

String

Sorties

PSExpressRouteGateway