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

New-AzNetworkInterfaceIpConfig

Модуль:
Az.Network Module

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

Синтаксис

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

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

SetByResourceId 

New-AzNetworkInterfaceIpConfig
    -Name <String>
    [-PrivateIPAddressPrefixLength <Int32>]
    [-PrivateIpAddressVersion <String>]
    [-PrivateIpAddress <String>]
    [-Primary]
    [-SubnetId <String>]
    [-PublicIpAddressId <String>]
    [-LoadBalancerBackendAddressPoolId <String[]>]
    [-LoadBalancerInboundNatRuleId <String[]>]
    [-ApplicationGatewayBackendAddressPoolId <String[]>]
    [-ApplicationSecurityGroupId <String[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Описание

Командлет New-AzNetworkInterfaceIpConfig создает IP-конфигурацию сетевого интерфейса Azure для сетевого интерфейса.

Примеры

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

$vnet = Get-AzVirtualNetwork -Name myvnet -ResourceGroupName myrg
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$PIP1 = Get-AzPublicIpAddress -Name "PIP1" -ResourceGroupName "RG1"

$IPConfig1 = New-AzNetworkInterfaceIpConfig -Name "IPConfig-1" -Subnet $Subnet -PublicIpAddress $PIP1 -Primary

$nic = New-AzNetworkInterface -Name mynic1 -ResourceGroupName myrg -Location westus -IpConfiguration $IpConfig1

Первые две команды получают виртуальную сеть с именем myvnet и подсеть с именем mysubnet соответственно, которые были созданы ранее. Они хранятся в $vnet и $Subnet соответственно. Третья команда получает ранее созданный общедоступный IP-адрес с именем PIP1. Следующая команда создает новую IP-конфигурацию с именем IPConfig-1 в качестве основной IP-конфигурации с общедоступным IP-адресом, связанным с ним. Последняя команда создает сетевой интерфейс с именем mynic1 с помощью этой IP-конфигурации.

Пример 2. Создание IP-конфигурации с частным IP-адресом

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

$IPConfig2 = New-AzNetworkInterfaceIpConfig -Name "IP-Config2" -Subnet $Subnet -PrivateIpAddress 10.0.0.5

$nic = New-AzNetworkInterface -Name mynic1 -ResourceGroupName myrg -Location westus -IpConfiguration $IpConfig2

Первые две команды получают виртуальную сеть с именем myvnet и подсеть с именем mysubnet соответственно, которые были созданы ранее. Они хранятся в $vnet и $Subnet соответственно. Третья команда создает новую IP-конфигурацию с именем IPConfig-2 с частным IP-адресом 10.0.0.5, связанным с ним. Последняя команда создает сетевой интерфейс с именем mynic1 с помощью этой IP-конфигурации.

Пример 3

Создает IP-конфигурацию сетевого интерфейса. (autogenerated)

New-AzNetworkInterfaceIpConfig -Name 'IP-Config2' -PrivateIpAddress '10.0.1.10' -PrivateIpAddressVersion IPv4 -SubnetId <String>

Параметры

-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

Ссылка на ресурс поставщика LoadBalancer шлюза.

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

Тип: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-правила подсистемы балансировки нагрузки, к которой принадлежит IPConfiguration этого сетевого интерфейса.

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

Тип:

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

-Primary

Командлет New-AzNetworkInterfaceIpConfig создает IP-конфигурацию сетевого интерфейса Azure для сетевого интерфейса.

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

Тип: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

-PrivateIPAddressPrefixLength

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

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

Тип:

Nullable<T>[Int32]

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.

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

String

PSBackendAddressPool

PSInboundNatRule

PSApplicationGatewayBackendAddressPool

PSApplicationSecurityGroup

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

PSNetworkInterfaceIPConfiguration

Примечания

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