Set-AzNetworkInterfaceIpConfig

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

Синтаксис

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>]
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-адрес ipconfig1-конфигурации первичной IP-конфигурации 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-адреса сетевого интерфейса.

Type:PSApplicationGatewayBackendAddressPool[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ApplicationGatewayBackendAddressPoolId

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ApplicationSecurityGroup

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

Type:PSApplicationSecurityGroup[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ApplicationSecurityGroupId

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GatewayLoadBalancerId

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LoadBalancerBackendAddressPool

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

Type:PSBackendAddressPool[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LoadBalancerBackendAddressPoolId

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LoadBalancerInboundNatRule

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

Type:PSInboundNatRule[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LoadBalancerInboundNatRuleId

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NetworkInterface

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

Type:PSNetworkInterface
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Primary

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrivateIpAddress

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrivateIpAddressVersion

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

  • IPv4
  • IPv6
Type:String
Accepted values:IPv4, IPv6
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublicIpAddress

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

Type:PSPublicIpAddress
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublicIpAddressId

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Subnet

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

Type:PSSubnet
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SubnetId

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

PSNetworkInterface

String[]

PSBackendAddressPool[]

PSInboundNatRule[]

PSApplicationGatewayBackendAddressPool[]

PSApplicationSecurityGroup[]

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

PSNetworkInterface

Примечания

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