다음을 통해 공유

Add-AzNetworkInterfaceIpConfig

모듈:
Az.Network Module

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

구문

SetByResource (기본값) 

Add-AzNetworkInterfaceIpConfig
    -Name <String>
    -NetworkInterface <PSNetworkInterface>
    [-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 

Add-AzNetworkInterfaceIpConfig
    -Name <String>
    -NetworkInterface <PSNetworkInterface>
    [-PrivateIPAddressPrefixLength <Int32>]
    [-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[]

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
별칭: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

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

매개 변수 속성

형식:

PSInboundNatRule[]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

SetByResource
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-LoadBalancerInboundNatRuleId

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

매개 변수 속성

형식:

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

-NetworkInterface

NetworkInterface 개체를 지정합니다. 이 cmdlet은 이 매개 변수가 지정하는 개체에 네트워크 인터페이스 IP 구성을 추가합니다.

매개 변수 속성

형식:PSNetworkInterface
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:True
파이프라인의 값:True
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Primary

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

매개 변수 속성

형식: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 개체를 지정합니다. 이 cmdlet은 이 네트워크 인터페이스 IP 구성과 연결할 공용 IP 주소에 대한 참조를 만듭니다.

매개 변수 속성

형식:PSPublicIpAddress
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

SetByResource
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-PublicIpAddressId

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

SetByResourceId
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Subnet

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

매개 변수 속성

형식:PSSubnet
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

SetByResource
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-SubnetId

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

SetByResourceId
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

PSNetworkInterface

String

PSBackendAddressPool

PSInboundNatRule

PSApplicationGatewayBackendAddressPool

PSApplicationSecurityGroup

출력

PSNetworkInterface

참고

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