Поделиться через

Set-AzExpressRouteGateway

Модуль:
Az.Network Module

Обновляет масштабируемый шлюз ExpressRoute.

Синтаксис

ByExpressRouteGatewayName (по умолчанию) 

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

Описание

Командлет Set-AzExpressRouteGateway позволяет обновить единицы масштабирования для существующего ExpressRouteGateway или обновить теги ресурсов.

Примеры

Пример 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

Выше будет создана группа ресурсов testRG, Виртуальная глобальная сеть и виртуальный концентратор в западной части США в этой группе ресурсов в Azure. После этого шлюз ExpressRoute будет создан в Виртуальном концентраторе с 2 единицами масштабирования, которые затем будут изменены на 3 единицы масштабирования.

Пример 2. Настройте этот шлюз для приема трафика из сетей виртуальной глобальной сети.

Вы можете получить шлюз, настроить его свойство AllowNonVirtualWanTraffic и сохранить изменения в шлюзе или просто использовать переключатель в командлете 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

Пример 3. Настройте этот шлюз для блокировки трафика из сетей, отличных от виртуальной глобальной сети.

Вы можете получить шлюз, настроить его свойство AllowNonVirtualWanTraffic и сохранить изменения в шлюзе или просто использовать переключатель в командлете 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

Параметры

-AllowNonVirtualWanTraffic

Определяет, должен ли этот шлюз принимать трафик из других виртуальных сетей.

Свойства параметра

Тип:

Nullable<T>[Boolean]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-AsJob

Запуск командлета в фоновом режиме

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для взаимодействия с Azure.

Свойства параметра

Тип:IAzureContextContainer
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-InputObject

ExpressRouteGateway, который необходимо обновить.

Свойства параметра

Тип:PSExpressRouteGateway
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:ExpressRouteGateway

Наборы параметров

ByExpressRouteGatewayObject
Position:Named
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-MaxScaleUnits

Максимальное количество единиц масштабирования для этого ExpressRouteGateway. Допустимый диапазон > 2

Свойства параметра

Тип:UInt32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-MinScaleUnits

Минимальное количество единиц масштабирования для этого ExpressRouteGateway. Допустимый диапазон > 2

Свойства параметра

Тип:UInt32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Name

Имя ресурса.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:ИмяРесурса, ExpressRouteGatewayName, Имя шлюза

Наборы параметров

ByExpressRouteGatewayName
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ResourceGroupName

Имя группы ресурсов Для обновления ExpressRouteGateway.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ByExpressRouteGatewayName
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ResourceId

Идентификатор ExpressRouteGateway, который необходимо обновить.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ByExpressRouteGatewayResourceId
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Tag

Хэш-файл, представляющий теги ресурсов.

Свойства параметра

Тип:Hashtable
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WhatIf

Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входные данные

PSVirtualHub

String

Выходные данные

PSExpressRouteGateway