Set-AzureRmNetworkInterfaceIpConfig
Задает состояние цели для IP-конфигурации сетевого интерфейса Azure.
Предупреждение
Модуль AzureRM PowerShell официально устарел с 29 февраля 2024 г. Пользователям рекомендуется выполнить миграцию из AzureRM в модуль Az PowerShell, чтобы обеспечить постоянную поддержку и обновления.
Хотя модуль AzureRM по-прежнему может функционировать, он больше не поддерживается или не поддерживается, размещая любое постоянное использование на усмотрение и риск пользователя. Ознакомьтесь с нашими ресурсами миграции, чтобы получить рекомендации по переходу в модуль Az.
Синтаксис
Set-AzureRmNetworkInterfaceIpConfig
-Name <String>
-NetworkInterface <PSNetworkInterface>
[-PrivateIpAddressVersion <String>]
[-PrivateIpAddress <String>]
[-Primary]
[-Subnet <PSSubnet>]
[-PublicIpAddress <PSPublicIpAddress>]
[-LoadBalancerBackendAddressPool <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSBackendAddressPool]>]
[-LoadBalancerInboundNatRule <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSInboundNatRule]>]
[-ApplicationGatewayBackendAddressPool <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool]>]
[-ApplicationSecurityGroup <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationSecurityGroup]>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Set-AzureRmNetworkInterfaceIpConfig
-Name <String>
-NetworkInterface <PSNetworkInterface>
[-PrivateIpAddressVersion <String>]
[-PrivateIpAddress <String>]
[-Primary]
[-SubnetId <String>]
[-PublicIpAddressId <String>]
[-LoadBalancerBackendAddressPoolId <System.Collections.Generic.List`1[System.String]>]
[-LoadBalancerInboundNatRuleId <System.Collections.Generic.List`1[System.String]>]
[-ApplicationGatewayBackendAddressPoolId <System.Collections.Generic.List`1[System.String]>]
[-ApplicationSecurityGroupId <System.Collections.Generic.List`1[System.String]>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Описание
Командлет Set-AzureRmNetworkInterfaceIpConfig задает состояние цели для IP-конфигурации сетевого интерфейса Azure.
Примеры
1. Изменение IP-адреса конфигурации IP-адресов
$vnet = Get-AzureRmVirtualNetwork -Name myvnet -ResourceGroupName myrg
$subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$nic = Get-AzureRmNetworkInterface -Name nic1 -ResourceGroupName myrg
$nic | Set-AzureRmNetworkInterfaceIpConfig -Name ipconfig1 -PrivateIpAddress 10.0.0.11 -Subnet $subnet
-Primary
$nic | Set-AzureRmNetworkInterfaceПервые две команды получают виртуальную сеть с именем myvnet и подсеть с именем mysubnet и хранят ее в переменных $vnet и $subnet соответственно. Третья команда получает сетевой интерфейс nic1, связанный с конфигурацией IP-адресов, которая должна быть обновлена. Третья команда задает частный IP-адрес основной IP-конфигурации ipconfig1 на 10.0.0.11. Наконец, последняя команда обновляет сетевой интерфейс, гарантируя успешное внесение изменений.
2. Связывание IP-конфигурации с группой безопасности приложений
$vnet = Get-AzureRmVirtualNetwork -Name myvnet -ResourceGroupName myrg
$subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$asg = Get-ApplicationSecurityGroup -Name myasg -ResourceGroupName myrg
$nic = Get-AzureRmNetworkInterface -Name nic1 -ResourceGroupName myrg
$nic | Set-AzureRmNetworkInterfaceIpConfig -Name ipconfig1 -PrivateIpAddress 10.0.0.11 -Subnet $subnet -ApplicationSecurityGroup $asg
-Primary
$nic | Set-AzureRmNetworkInterfaceВ этом примере переменная $asg содержит ссылку на группу безопасности приложений. Четвертая команда получает сетевой интерфейс nic1, связанный с конфигурацией IP-адресов, которая должна быть обновлена. Set-AzureRmNetworkInterfaceIpConfig задает частный IP-адрес основной IP-конфигурации ipconfig1 на 10.0.0.11 и создает связь с полученной группой безопасности приложений. Наконец, последняя команда обновляет сетевой интерфейс, гарантируя успешное внесение изменений.
Параметры
-ApplicationGatewayBackendAddressPool
Указывает коллекцию ссылок внутреннего пула адресов шлюза приложений, к которым принадлежит эта конфигурация IP-адреса сетевого интерфейса.
| Type: | List<T>[PSApplicationGatewayBackendAddressPool] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ApplicationGatewayBackendAddressPoolId
Указывает коллекцию ссылок внутреннего пула адресов шлюза приложений, к которым принадлежит эта конфигурация IP-адреса сетевого интерфейса.
| Type: | List<T>[String] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ApplicationSecurityGroup
Указывает коллекцию ссылок на группу безопасности приложений, к которой принадлежит эта конфигурация IP-адреса сетевого интерфейса.
| Type: | List<T>[PSApplicationSecurityGroup] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ApplicationSecurityGroupId
Указывает коллекцию ссылок на группу безопасности приложений, к которой принадлежит эта конфигурация IP-адреса сетевого интерфейса.
| Type: | List<T>[String] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.
| Type: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LoadBalancerBackendAddressPool
Указывает коллекцию ссылок на серверный пул адресов подсистемы балансировки нагрузки, к которой принадлежит эта конфигурация IP-адреса сетевого интерфейса.
| Type: | List<T>[PSBackendAddressPool] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-LoadBalancerBackendAddressPoolId
Указывает коллекцию ссылок на серверный пул адресов подсистемы балансировки нагрузки, к которой принадлежит эта конфигурация IP-адреса сетевого интерфейса.
| Type: | List<T>[String] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-LoadBalancerInboundNatRule
Указывает коллекцию правил преобразования сетевых адресов (NAT) подсистемы балансировки нагрузки, к которой относится ip-конфигурация сетевого интерфейса.
| Type: | List<T>[PSInboundNatRule] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-LoadBalancerInboundNatRuleId
Указывает коллекцию ссылок на правило NAT для входящего трафика подсистемы балансировки нагрузки, к которому принадлежит эта конфигурация IP-интерфейса.
| Type: | List<T>[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 |
Входные данные
Параметры: NetworkInterface (ByValue)
List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
List<T>[[Microsoft.Azure.Commands.Network.Models.PSBackendAddressPool, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]
List<T>[[Microsoft.Azure.Commands.Network.Models.PSInboundNatRule, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]
List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]
List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationSecurityGroup, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]
Выходные данные
Примечания
- Ключевые слова: azure, azurerm, arm, resource, management, manager, network, networking