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-адреса сетевого интерфейса.
| Тип: | PSApplicationGatewayBackendAddressPool[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-ApplicationGatewayBackendAddressPoolId
Указывает коллекцию ссылок внутреннего пула адресов шлюза приложений, к которым принадлежит эта конфигурация IP-адреса сетевого интерфейса.
| Тип: | String[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-ApplicationSecurityGroup
Указывает коллекцию ссылок на группу безопасности приложений, к которой принадлежит эта конфигурация IP-адреса сетевого интерфейса.
| Тип: | PSApplicationSecurityGroup[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-ApplicationSecurityGroupId
Указывает коллекцию ссылок на группу безопасности приложений, к которой принадлежит эта конфигурация IP-адреса сетевого интерфейса.
| Тип: | String[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.
| Тип: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-GatewayLoadBalancerId
Указывает идентификатор интерфейсной ip-конфигурации поставщика подсистемы балансировки нагрузки шлюза.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-LoadBalancerBackendAddressPool
Указывает коллекцию ссылок на серверный пул адресов подсистемы балансировки нагрузки, к которой принадлежит эта конфигурация IP-адреса сетевого интерфейса.
| Тип: | PSBackendAddressPool[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-LoadBalancerBackendAddressPoolId
Указывает коллекцию ссылок на серверный пул адресов подсистемы балансировки нагрузки, к которой принадлежит эта конфигурация IP-адреса сетевого интерфейса.
| Тип: | String[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-LoadBalancerInboundNatRule
Указывает коллекцию правил преобразования сетевых адресов (NAT) подсистемы балансировки нагрузки, к которой относится ip-конфигурация сетевого интерфейса.
| Тип: | PSInboundNatRule[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-LoadBalancerInboundNatRuleId
Указывает коллекцию ссылок на правило NAT для входящего трафика подсистемы балансировки нагрузки, к которому принадлежит эта конфигурация IP-интерфейса.
| Тип: | String[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Name
Указывает имя сетевой IP-конфигурации, для которой этот командлет задает.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-NetworkInterface
Указывает объект NetworkInterface . Этот командлет добавляет IP-конфигурацию сетевого интерфейса в объект, указанный этим параметром.
| Тип: | PSNetworkInterface |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Primary
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-PrivateIpAddress
Указывает статический IP-адрес конфигурации IP-адреса сетевого интерфейса.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-PrivateIpAddressVersion
Указывает версию IP-адреса конфигурации IP-адреса сетевого интерфейса. Допустимые значения для этого параметра:
- IPv4
- IPv6
| Тип: | String |
| Допустимые значения: | IPv4, IPv6 |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-PublicIpAddress
Указывает объект PublicIPAddress . Этот командлет создает ссылку на общедоступный IP-адрес для связывания с этой конфигурацией IP-адреса сетевого интерфейса.
| Тип: | PSPublicIpAddress |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-PublicIpAddressId
Этот командлет создает ссылку на общедоступный IP-адрес для связывания с этой конфигурацией IP-адреса сетевого интерфейса.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Subnet
Указывает объект подсети . Этот командлет создает ссылку на подсеть, в которой создается конфигурация IP-адреса сетевого интерфейса.
| Тип: | PSSubnet |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-SubnetId
Этот командлет создает ссылку на подсеть, в которой создается конфигурация IP-адреса сетевого интерфейса.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
Входные данные
String[]
PSApplicationGatewayBackendAddressPool[]
Выходные данные
Примечания
- Ключевые слова: azure, azurerm, arm, resource, management, manager, network, networking