Add-AzNetworkInterfaceIpConfig

모듈:

Az.Network

네트워크 인터페이스 IP 구성을 네트워크 인터페이스에 추가합니다.

구문

Add-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>]

Add-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>]

Description

Add-AzNetworkInterfaceIpConfig cmdlet은 Azure 네트워크 인터페이스에 네트워크 인터페이스 IP 구성을 추가합니다.

예제

예제 1: 애플리케이션 보안 그룹을 사용하여 새 IP 구성 추가

$subnet = New-AzVirtualNetworkSubnetConfig -Name MySubnet -AddressPrefix 10.0.1.0/24
$vnet = New-AzVirtualNetwork -Name MyVNET -ResourceGroupName MyResourceGroup -Location "West US" -AddressPrefix 10.0.0.0/16 -Subnet $subnet

$nic = New-AzNetworkInterface -Name MyNetworkInterface -ResourceGroupName MyResourceGroup -Location "West US" -Subnet $vnet.Subnets[0]

$asg = New-AzApplicationSecurityGroup -ResourceGroupName MyResourceGroup -Name MyASG -Location "West US"

$nic | Set-AzNetworkInterfaceIpConfig -Name $nic.IpConfigurations[0].Name -Subnet $vnet.Subnets[0] -ApplicationSecurityGroup $asg | Set-AzNetworkInterface

$nic | Add-AzNetworkInterfaceIpConfig -Name MyNewIpConfig -Subnet $vnet.Subnets[0] -ApplicationSecurityGroup $asg | Set-AzNetworkInterface

이 예제에서는 새 가상 네트워크 MyVNET의 서브넷에 속하는 새 네트워크 인터페이스 MyNetworkInterface를 만듭니다. 또한 네트워크 인터페이스의 IP 구성과 연결할 빈 애플리케이션 보안 그룹 MyASG를 만듭니다. 두 개체가 모두 만들어지면 기본 IP 구성을 MyASG 개체에 연결합니다. 마지막으로, 애플리케이션 보안 그룹 개체에 연결된 네트워크 인터페이스에 새 IP 구성을 만듭니다.

매개 변수

-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

이 네트워크 인터페이스 IP 구성이 속한 부하 분산 장치 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

-NetworkInterface

NetworkInterface 개체를 지정합니다. 이 cmdlet은 이 매개 변수가 지정하는 개체에 네트워크 인터페이스 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 개체를 지정합니다. 이 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

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

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

입력

PSNetworkInterface

String[]

PSBackendAddressPool[]

PSInboundNatRule[]

PSApplicationGatewayBackendAddressPool[]

PSApplicationSecurityGroup[]

출력

PSNetworkInterface

참고

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

관련 링크

• Get-AzNetworkInterfaceIpConfig
• New-AzNetworkInterfaceIpConfig
• Remove-AzNetworkInterfaceIpConfig
• Set-AzNetworkInterfaceIpConfig