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

Set-AzNetworkInterfaceIpConfig

Модуль:
Az.Network Module

Обновляет IP-конфигурацию для сетевого интерфейса.

Синтаксис

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

Set-AzNetworkInterfaceIpConfig
    -Name <String>
    -NetworkInterface <PSNetworkInterface>
    [-PrivateIpAddressVersion <String>]
    [-PrivateIpAddress <String>]
    [-Primary]
    [-Subnet <PSSubnet>]
    [-PublicIpAddress <PSPublicIpAddress>]
    [-LoadBalancerBackendAddressPool <PSBackendAddressPool[]>]
    [-LoadBalancerInboundNatRule <PSInboundNatRule[]>]
    [-ApplicationGatewayBackendAddressPool <PSApplicationGatewayBackendAddressPool[]>]
    [-ApplicationSecurityGroup <PSApplicationSecurityGroup[]>]
    [-GatewayLoadBalancerId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SetByResourceId 

Set-AzNetworkInterfaceIpConfig
    -Name <String>
    -NetworkInterface <PSNetworkInterface>
    [-PrivateIpAddressVersion <String>]
    [-PrivateIpAddress <String>]
    [-Primary]
    [-SubnetId <String>]
    [-PublicIpAddressId <String>]
    [-LoadBalancerBackendAddressPoolId <String[]>]
    [-LoadBalancerInboundNatRuleId <String[]>]
    [-ApplicationGatewayBackendAddressPoolId <String[]>]
    [-ApplicationSecurityGroupId <String[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Описание

Командлет Set-AzNetworkInterfaceIpConfig обновляет ip-конфигурацию для сетевого интерфейса.

Примеры

Пример 1. Изменение IP-адреса конфигурации IP-адреса

$vnet = Get-AzVirtualNetwork -Name myvnet -ResourceGroupName myrg
$subnet = Get-AzVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet

$nic = Get-AzNetworkInterface -Name nic1 -ResourceGroupName myrg

$nic | Set-AzNetworkInterfaceIpConfig -Name ipconfig1 -PrivateIpAddress 10.0.0.11 -Subnet $subnet -Primary

$nic | Set-AzNetworkInterface

Первые две команды получают виртуальную сеть с именем myvnet и подсеть с именем mysubnet и хранят ее в переменных $vnet и $subnet соответственно. Третья команда получает сетевой интерфейс nic1, связанный с конфигурацией IP-адресов, которая должна быть обновлена. Третья команда задает частный IP-адрес основной IP-конфигурации ipconfig1 на 10.0.0.11. Наконец, последняя команда обновляет сетевой интерфейс, гарантируя успешное внесение изменений.

Пример 2. Связывание IP-конфигурации с группой безопасности приложений

$vnet = Get-AzVirtualNetwork -Name myvnet -ResourceGroupName myrg
$subnet = Get-AzVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$asg = Get-AzApplicationSecurityGroup -Name myasg -ResourceGroupName myrg

$nic = Get-AzNetworkInterface -Name nic1 -ResourceGroupName myrg

$nic | Set-AzNetworkInterfaceIpConfig -Name ipconfig1 -PrivateIpAddress 10.0.0.11 -Subnet $subnet -ApplicationSecurityGroup $asg -Primary

$nic | Set-AzNetworkInterface

В этом примере переменная $asg содержит ссылку на группу безопасности приложений. Четвертая команда получает сетевой интерфейс nic1, связанный с конфигурацией IP-адресов, которая должна быть обновлена. Set-AzNetworkInterfaceIpConfig задает частный IP-адрес основной IP-конфигурации ipconfig1 значение 10.0.0.11 и создает связь с полученной группой безопасности приложений. Наконец, последняя команда обновляет сетевой интерфейс, гарантируя успешное внесение изменений.

Пример 3. Отмена связывания IP-конфигурации с пулом внутренних адресов шлюза приложений

$nic = Get-AzNetworkInterface -Name nic1 -ResourceGroupName myrg

$nic | Set-AzNetworkInterfaceIpConfig -Name ipconfig1 -ApplicationGatewayBackendAddressPool $null

$nic | Set-AzNetworkInterface

Параметр Set-AzNetworkInterfaceIpConfig задает серверный пул адресов шлюза приложений ipconfig1 ipconfig1 на значение NULL и отсоединяется от сетевого интерфейса. Наконец, последняя команда обновляет сетевой интерфейс, гарантируя успешное внесение изменений.

Параметры

-ApplicationGatewayBackendAddressPool

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

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

Тип:

PSApplicationGatewayBackendAddressPool[]

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

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

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

-ApplicationGatewayBackendAddressPoolId

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

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

Тип:

String[]

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

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

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

-ApplicationSecurityGroup

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

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

Тип:

PSApplicationSecurityGroup[]

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

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

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

-ApplicationSecurityGroupId

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

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

Тип:

String[]

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

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

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

-DefaultProfile

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

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

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

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

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

-GatewayLoadBalancerId

Указывает идентификатор интерфейсной ip-конфигурации поставщика подсистемы балансировки нагрузки шлюза.

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

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

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

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

-LoadBalancerBackendAddressPool

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

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

Тип:

PSBackendAddressPool[]

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

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

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

-LoadBalancerBackendAddressPoolId

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

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

Тип:

String[]

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

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

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

-LoadBalancerInboundNatRule

Указывает коллекцию правил преобразования сетевых адресов (NAT) подсистемы балансировки нагрузки, к которой относится ip-конфигурация сетевого интерфейса.

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

Тип:

PSInboundNatRule[]

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

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

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

-LoadBalancerInboundNatRuleId

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

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

Тип:

String[]

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

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

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

-Name

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

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

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

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

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

-NetworkInterface

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

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

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

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

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

-Primary

Командлет Set-AzNetworkInterfaceIpConfig обновляет ip-конфигурацию для сетевого интерфейса.

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

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

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

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

-PrivateIpAddress

Указывает статический IP-адрес конфигурации IP-адреса сетевого интерфейса.

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

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

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

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

-PrivateIpAddressVersion

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

  • IPv4
  • IPv6

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

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

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

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

-PublicIpAddress

Указывает объект PublicIPAddress. Этот командлет создает ссылку на общедоступный IP-адрес для связывания с этой конфигурацией IP-адреса сетевого интерфейса.

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

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

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

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

-PublicIpAddressId

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

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

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

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

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

-Subnet

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

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

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

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

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

-SubnetId

Этот командлет создает ссылку на подсеть, в которой создается конфигурация 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.

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

PSNetworkInterface

String

PSBackendAddressPool

PSInboundNatRule

PSApplicationGatewayBackendAddressPool

PSApplicationSecurityGroup

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

PSNetworkInterface

Примечания

  • Ключевые слова: azure, azurerm, arm, resource, management, manager, network, networking