다음을 통해 공유


New-AzureRmVmssIpConfig

VMSS의 네트워크 인터페이스에 대한 IP 구성을 만듭니다.

Warning

AzureRM PowerShell 모듈은 2024년 2월 29일부터 공식적으로 사용되지 않습니다. 사용자는 지속적인 지원 및 업데이트를 보장하기 위해 AzureRM에서 Az PowerShell 모듈로 마이그레이션하는 것이 좋습니다.

AzureRM 모듈은 여전히 작동할 수 있지만 더 이상 유지 관리되거나 지원되지 않으므로 사용자의 재량에 따라 계속 사용할 수 있습니다. Az 모듈로 전환하는 방법에 대한 지침은 마이그레이션 리소스를 참조하세요.

구문

New-AzureRmVmssIpConfig
   [[-Name] <String>]
   [[-Id] <String>]
   [[-SubnetId] <String>]
   [[-ApplicationGatewayBackendAddressPoolsId] <String[]>]
   [[-LoadBalancerBackendAddressPoolsId] <String[]>]
   [[-LoadBalancerInboundNatPoolsId] <String[]>]
   [-Primary]
   [-PrivateIPAddressVersion <String>]
   [-PublicIPAddressConfigurationName <String>]
   [-PublicIPAddressConfigurationIdleTimeoutInMinutes <Int32>]
   [-DnsSetting <String>]
   [-IpTag <VirtualMachineScaleSetIpTag[]>]
   [-PublicIPPrefix <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-AzureRmVmssIpConfig cmdlet은 VMSS(Virtual Machine Scale Set)의 네트워크 인터페이스에 대한 IP 구성 개체를 만듭니다. 이 cmdlet의 구성을 Add-AzureRmVmssNetworkInterfaceConfiguration cmdlet의 IPConfiguration 매개 변수로 지정합니다.

예제

예제 1: VMSS 인터페이스에 대한 IP 구성 개체 만들기

PS C:\> $IPConfiguration = New-AzureRmVmssIPConfig -Name "ContosoVmssInterface02" -SubnetId $SubnetId

이 명령은 ContosoVmssInterface02라는 IP 구성 개체를 만듭니다. 이 명령은 $SubnetId 저장된 이전에 정의된 서브넷 ID를 사용합니다. 이 명령은 나중에 Add-AzureRmVmssNetworkInterfaceConfiguration에서 사용할 수 있는 구성 설정을 $IPConfiguration 변수에 저장합니다.

예제 2: NAT 풀 설정을 포함하는 IP 구성 개체 만들기

PS C:\> $IPConfiguration = New-AzureRmVmssIPConfig -Name "ContosoVmssInterface03" -LoadBalancerInboundNatPoolsId $expectedLb.InboundNatPools[0].Id -LoadBalancerBackendAddressPoolsId $expectedLb.BackendAddressPools[0].Id -SubnetId $SubnetId

이 명령은 ContosoVmssInterface03이라는 IP 구성 개체를 만든 다음 나중에 사용하기 위해 $IPConfiguration 변수에 저장합니다. 이 명령은 $SubnetId 저장된 이전에 정의된 서브넷 ID를 사용합니다. 이 명령은 나중에 사용할 수 $IPConfiguration 변수에 구성 설정을 저장합니다. 이 명령은 LoadBalancerInboundNatPoolsId 및 LoadBalancerBackendAddressPoolsId 매개 변수에 대한 값을 지정합니다.

매개 변수

-ApplicationGatewayBackendAddressPoolsId

부하 분산 장치의 백 엔드 주소 풀에 대한 참조 배열을 지정합니다. 확장 집합은 하나의 공용 및 하나의 내부 부하 분산 장치의 백 엔드 주소 풀을 참조할 수 있습니다. 여러 확장 집합은 동일한 부하 분산 장치를 사용할 수 없습니다.

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

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

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

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:IAzureContextContainer
별칭:AzureRmContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DnsSetting

publicIP 주소에 적용할 dns 설정입니다. publicIP 주소에 적용할 Dns 설정의 도메인 이름 레이블입니다. 도메인 이름 레이블 및 vm 인덱스의 연결은 생성될 공용 IP 주소 리소스의 도메인 이름 레이블입니다.

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

-Id

ID를 지정합니다.

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

-IpTag

IP 태그 개체의 배열을 지정합니다.

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

-LoadBalancerBackendAddressPoolsId

부하 분산 장치의 들어오는 NAT(네트워크 주소 변환) 풀에 대한 참조 배열을 지정합니다. 확장 집합은 하나의 공용 및 하나의 내부 부하 분산 장치의 들어오는 NAT 풀을 참조할 수 있습니다. 여러 확장 집합은 동일한 부하 분산 장치를 사용할 수 없습니다.

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

-LoadBalancerInboundNatPoolsId

부하 분산 장치의 들어오는 NAT 풀에 대한 참조 배열을 지정합니다. 확장 집합은 하나의 공용 및 하나의 내부 부하 분산 장치의 들어오는 NAT 풀을 참조할 수 있습니다. 여러 확장 집합은 동일한 부하 분산 장치를 사용할 수 없습니다.

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

-Name

IP 구성의 이름을 지정합니다.

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

-Primary

네트워크 인터페이스에 둘 이상의 IP 구성이 있는 경우 기본 IP 구성을 지정합니다.

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

-PrivateIPAddressVersion

IP 구성이 IPv4 또는 IPv6인지 지정합니다. 기본값은 IPv4로 사용됩니다. 가능한 값은 'IPv4' 및 'IPv6'입니다.

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

-PublicIPAddressConfigurationIdleTimeoutInMinutes

공용 IP 주소의 유휴 시간 제한입니다.

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

-PublicIPAddressConfigurationName

publicIP 주소 구성 이름입니다.

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

-PublicIPPrefix

공용 IP 접두사 ID

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

-SubnetId

구성에서 VMSS 네트워크 인터페이스를 만드는 서브넷 ID를 지정합니다.

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

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

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

입력

String

String[]

Int32

VirtualMachineScaleSetIpTag[]

출력

VirtualMachineScaleSetIPConfiguration