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

Set-AzApplicationGatewayFrontendIPConfig

Модуль:
Az.Network Module

Изменяет конфигурацию внешнего IP-адреса.

Синтаксис

SetByResourceId 

Set-AzApplicationGatewayFrontendIPConfig
    -ApplicationGateway <PSApplicationGateway>
    -Name <String>
    [-PrivateIPAddress <String>]
    [-SubnetId <String>]
    [-PublicIPAddressId <String>]
    [-PrivateLinkConfigurationId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SetByResource 

Set-AzApplicationGatewayFrontendIPConfig
    -ApplicationGateway <PSApplicationGateway>
    -Name <String>
    [-PrivateIPAddress <String>]
    [-Subnet <PSSubnet>]
    [-PublicIPAddress <PSPublicIpAddress>]
    [-PrivateLinkConfiguration <PSApplicationGatewayPrivateLinkConfiguration>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Описание

Командлет Set-AzApplicationGatewayFrontendIPConfig обновляет интерфейсную IP-конфигурацию. Шлюз приложений поддерживает два типа интерфейсных IP-адресов:

  • Общедоступные IP-адреса
  • Частные IP-адреса, для которых конфигурация использует внутреннюю балансировку нагрузки (ILB) Шлюз приложений может иметь по крайней мере один общедоступный IP-адрес и один частный IP-адрес. Общедоступный IP-адрес и частный IP-адрес должны быть добавлены отдельно в качестве внешних IP-адресов.

Примеры

Пример 1. Настройка общедоступного IP-адреса в качестве внешнего IP-адреса шлюза приложений

$PublicIp = New-AzPublicIpAddress -ResourceGroupName "ResourceGroup01" -Name "PublicIp01" -location "West US" -AllocationMethod Dynamic
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontEndIp01" -PublicIPAddress $PublicIp

Первая команда создает объект общедоступного IP-адреса и сохраняет его в переменной $PublicIp. Вторая команда получает шлюз приложений с именем ApplicationGateway01, который принадлежит группе ресурсов с именем ResourceGroup01, и сохраняет его в переменной $AppGw. Третья команда обновляет интерфейсную IP-конфигурацию с именем FrontEndIp01 для шлюза в $AppGw, используя адрес, хранящийся в $PublicIp.

Пример 2. Установка статического частного IP-адреса в качестве внешнего IP-адреса шлюза приложений

$VNet = Get-AzVirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontendIP02" -Subnet $Subnet -PrivateIPAddress 10.0.1.1

Первая команда получает виртуальную сеть с именем VNet01, которая принадлежит группе ресурсов с именем ResourceGroup01, и сохраняет ее в переменной $VNet. Вторая команда получает конфигурацию подсети с именем Subnet01, используя $VNet из первой команды и сохраняет ее в переменной $Subnet. Третья команда получает шлюз приложений с именем ApplicationGateway01, который принадлежит группе ресурсов с именем ResourceGroup01, и сохраняет ее в переменной $AppGw. Четвертая команда добавляет интерфейсную IP-конфигурацию с именем FrontendIP02, используя $Subnet из второй команды и частный IP-адрес 10.0.1.1.

Пример 3. Настройка динамического частного IP-адреса в качестве внешнего IP-адреса шлюза приложений

$VNet = Get-AzVirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontendIP02" -Subnet $Subnet

Первая команда получает виртуальную сеть с именем VNet01, которая принадлежит группе ресурсов с именем ResourceGroup01, и сохраняет ее в переменной $VNet. Вторая команда получает конфигурацию подсети с именем Subnet01, используя $VNet из первой команды и сохраняет ее в переменной $Subnet. Третья команда получает шлюз приложений с именем ApplicationGateway01, который принадлежит группе ресурсов с именем ResourceGroup01, и сохраняет ее в переменной $AppGw. Четвертая команда добавляет интерфейсную IP-конфигурацию с именем FrontendIP02, используя $Subnet из второй команды.

Параметры

-ApplicationGateway

Указывает объект шлюза приложений, в котором необходимо изменить конфигурацию внешнего IP-адреса.

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

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

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

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

-DefaultProfile

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

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

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

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

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

-Name

Указывает имя интерфейсной IP-конфигурации, которая изменяет этот командлет.

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

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

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

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

-PrivateIPAddress

Указывает частный IP-адрес. Если этот IP-адрес указан, он статически выделяется из подсети.

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

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

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

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

-PrivateLinkConfiguration

PrivateLinkConfiguration (Конфигурация PrivateLink)

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

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

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

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

-PrivateLinkConfigurationId

PrivateLinkConfigurationId

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

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

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

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

-PublicIPAddress

Указывает общедоступный IP-адрес.

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

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

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

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

-PublicIPAddressId

Указывает идентификатор общедоступного IP-адреса.

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

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

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

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

-Subnet

Указывает подсеть, которую использует шлюз приложений. Укажите этот параметр, если шлюз использует частный IP-адрес. Если указан адрес PrivateIPAddress , он должен принадлежать этой подсети. Если PrivateIPAddress не указан, один из IP-адресов из этой подсети динамически выбирается в качестве внешнего IP-адреса шлюза приложений.

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

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

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

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

-SubnetId

Указывает идентификатор подсети. Укажите этот параметр, если шлюз использует частный IP-адрес. Если указан параметр PrivateIPAddress , он должен принадлежать этой подсети. Если PrivateIPAddress не указан, один из IP-адресов из этой подсети динамически выбирается в качестве внешнего IP-адреса шлюза приложений.

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

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

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

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

CommonParameters

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

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

PSApplicationGateway

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

PSApplicationGateway