New-AzNetworkInterfaceIpConfig

모듈:

Az.Network

네트워크 인터페이스 IP 구성을 만듭니다.

구문

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

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

Description

New-AzNetworkInterfaceIpConfig cmdlet은 네트워크 인터페이스에 대한 Azure 네트워크 인터페이스 IP 구성을 만듭니다.

예제

예제 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 저장됩니다. 세 번째 명령은 PIP1이라는 이전에 만든 공용 IP 주소를 가져옵니다. 다음 명령은 연결된 공용 IP 주소를 사용하여 기본 IP 구성으로 "IPConfig-1"이라는 새 IP 구성을 만듭니다. 그런 다음 마지막 명령은 이 IP 구성을 사용하여 mynic1이라는 네트워크 인터페이스를 만듭니다.

예제 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 주소 10.0.0.5가 연결된 "IPConfig-2"라는 새 IP 구성을 만듭니다. 그런 다음 마지막 명령은 이 IP 구성을 사용하여 mynic1이라는 네트워크 인터페이스를 만듭니다.

예제 3

네트워크 인터페이스 IP 구성을 만듭니다. (자동 생성됨)

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

매개 변수

-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
별칭:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-GatewayLoadBalancerId

게이트웨이 LoadBalancer 공급자 리소스의 참조입니다.

형식:	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

이 네트워크 인터페이스 IPConfiguration이 속한 부하 분산 장치 인바운드 Nat 규칙 참조의 컬렉션을 지정합니다.

형식:	PSInboundNatRule[]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-LoadBalancerInboundNatRuleId

이 네트워크 인터페이스 IP 구성이 속한 부하 분산 장치 NAT(네트워크 주소 변환) 규칙 참조의 컬렉션을 지정합니다.

형식:	String[]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-Name

네트워크 인터페이스 IP 구성의 이름을 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	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 개체를 지정합니다. 이 cmdlet은 이 네트워크 인터페이스 IP 구성과 연결할 공용 IP 주소에 대한 참조를 만듭니다.

형식:	PSPublicIpAddress
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-PublicIpAddressId

이 cmdlet은 이 네트워크 인터페이스 IP 구성과 연결할 공용 IP 주소에 대한 참조를 만듭니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Subnet

서브넷 개체를 지정합니다. 이 cmdlet은 이 네트워크 인터페이스 IP 구성이 만들어진 서브넷에 대한 참조를 만듭니다.

형식:	PSSubnet
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-SubnetId

이 네트워크 인터페이스 IP 구성이 만들어지는 서브넷에 대한 참조를 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

입력

String[]

PSBackendAddressPool[]

PSInboundNatRule[]

PSApplicationGatewayBackendAddressPool[]

PSApplicationSecurityGroup[]

출력

PSNetworkInterfaceIPConfiguration

참고

• 키워드: azure, azurerm, arm, 리소스, 관리, 관리자, 네트워크, 네트워킹

관련 링크

• Add-AzNetworkInterfaceIpConfig
• Get-AzNetworkInterfaceIpConfig
• Remove-AzNetworkInterfaceIpConfig
• Set-AzNetworkInterfaceIpConfig