다음을 통해 공유


New-AzPublicIpAddress

공용 IP 주소를 만듭니다.

구문

New-AzPublicIpAddress
   [-Name <String>]
   -ResourceGroupName <String>
   -Location <String>
   [-EdgeZone <String>]
   [-Sku <String>]
   [-Tier <String>]
   -AllocationMethod <String>
   [-IpAddressVersion <String>]
   [-DomainNameLabel <String>]
   [-DomainNameLabelScope <PSDomainNameLabelScopeType>]
   [-IpTag <PSPublicIpTag[]>]
   [-PublicIpPrefix <PSPublicIpPrefix>]
   [-DdosProtectionMode <String>]
   [-DdosProtectionPlanId <String>]
   [-ReverseFqdn <String>]
   [-IdleTimeoutInMinutes <Int32>]
   [-Zone <String[]>]
   [-IpAddress <String>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-AzPublicIpAddress cmdlet은 공용 IP 주소를 만듭니다.

예제

예제 1: 새 공용 IP 주소 만들기

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location

이 명령은 새 공용 IP 주소 리소스를 만듭니다. 이 리소스의 공용 IP 주소를 가리키는 $dnsPrefix.$location.cloudapp.azure.com DNS 레코드가 만들어집니다. -AllocationMethod가 'Static'으로 지정되면 공용 IP 주소가 이 리소스에 즉시 할당됩니다. '동적'으로 지정된 경우 연결된 리소스(예: VM 또는 부하 분산 장치)를 시작하거나 만들 때만 공용 IP 주소가 할당됩니다.

예제 2: 역방향 FQDN을 사용하여 공용 IP 주소 만들기

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -ReverseFqdn $customFqdn

이 명령은 새 공용 IP 주소 리소스를 만듭니다. -ReverseFqdn 매개 변수를 사용하여 Azure는 이 리소스에 할당된 공용 IP 주소에 대한 DNS PTR 레코드(역방향 조회)를 만들어 명령에 지정된 $customFqdn 가리킵니다. 필수 조건으로 $customFqdn(예: webapp.contoso.com)에는 $dnsPrefix.$location.cloudapp.azure.com 가리키는 DNS CNAME 레코드(앞으로 조회)가 있어야 합니다.

예제 3: IpTag를 사용하여 새 공용 IP 주소 만들기

$ipTag = New-AzPublicIpTag -IpTagType "FirstPartyUsage" -Tag "/Sql"
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -IpTag $ipTag

이 명령은 새 공용 IP 주소 리소스를 만듭니다. 이 리소스의 공용 IP 주소를 가리키는 $dnsPrefix.$location.cloudapp.azure.com DNS 레코드가 만들어집니다. -AllocationMethod가 'Static'으로 지정되면 공용 IP 주소가 이 리소스에 즉시 할당됩니다. '동적'으로 지정된 경우 연결된 리소스(예: VM 또는 부하 분산 장치)를 시작하거나 만들 때만 공용 IP 주소가 할당됩니다. Iptag는 리소스와 연결된 태그를 지정하는 데 사용됩니다. Iptag는 New-AzPublicIpTag를 사용하여 지정하고 -IpTags를 통해 입력으로 전달될 수 있습니다.

예제 4: 접두사에서 새 공용 IP 주소 만들기

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -PublicIpPrefix $publicIpPrefix -Sku Standard

이 명령은 새 공용 IP 주소 리소스를 만듭니다. 이 리소스의 공용 IP 주소를 가리키는 $dnsPrefix.$location.cloudapp.azure.com DNS 레코드가 만들어집니다. 공용 IP 주소는 지정된 publicIpPrefix에서 이 리소스에 즉시 할당됩니다. 이 옵션은 'Standard' Sku 및 'Static' AllocationMethod에 대해서만 지원됩니다.

예제 5: BYOIP 접두사에서 특정 공용 IP 주소 만들기

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -Location $location -IpAddress 0.0.0.0 -PublicIpPrefix $publicIpPrefix -Sku Standard

이 명령은 특정 IP를 사용하여 새 공용 IP 주소 리소스를 만듭니다. NRP는 지정된 IP가 PublicIpPrefix 내에 있는지, 지정된 PublicIpPrefix가 BYOIP PublicIpPrefix인지 확인합니다. 지정된 공용 IP 주소는 지정된 publicIpPrefix에서 이 리소스에 즉시 할당됩니다. 이 옵션은 'Standard' Sku 및 'Static' AllocationMethod 및 BYOIP PublicIpPrefix에 대해서만 지원됩니다.

예제 6: 새 전역 공용 IP 주소 만들기

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $domainNameLabel -Location $location -Sku Standard -Tier Global

이 명령은 새 전역 공용 IP 주소 리소스를 만듭니다. 이 리소스의 공용 IP 주소를 가리키는 $dnsPrefix.$location.cloudapp.azure.com DNS 레코드가 만들어집니다. 전역 공용 IP 주소는 이 리소스에 즉시 할당됩니다. 이 옵션은 'Standard' Sku 및 'Static' AllocationMethod에 대해서만 지원됩니다.

예제 7: DomainNameLabelScope를 사용하여 공용 IP 주소 만들기

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -DomainNameLabelScope $hasedReusePolicy -Location $location

이 명령은 새 공용 IP 주소 리소스를 만듭니다. -DomainNameLabelScope 매개 변수를 사용하여 Azure는 $hasedReusePolicy 제안된 정책을 사용하여 이 리소스에 할당된 공용 IP 주소에 대한 해시된 값을 FQDN으로 사용하여 DNS 레코드를 만듭니다.

매개 변수

-AllocationMethod

공용 IP 주소를 할당할 메서드를 지정합니다. 이 매개 변수에 허용되는 값은 정적 또는 동적입니다.

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

-AsJob

백그라운드에서 cmdlet 실행

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

-Confirm

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

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

-DdosProtectionMode

공용 IP 주소에 사용할 DdosProtectionMode

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

-DdosProtectionPlanId

공용 IP 주소에 연결할 DdosProtectionPlan ID

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

-DefaultProfile

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

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

-DomainNameLabel

공용 IP 주소의 상대 DNS 이름을 지정합니다.

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

-DomainNameLabelScope

공용 IP 주소의 DNS 이름에 대한 HashedReusePolicy를 지정합니다.

형식:Nullable<T>[PSDomainNameLabelScopeType]
허용되는 값:TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-EdgeZone

확장된 위치의 이름입니다.

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

-Force

사용자 확인을 요청하지 않고 명령을 강제 실행합니다.

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

-IdleTimeoutInMinutes

유휴 시간 제한(분)을 지정합니다.

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

-IpAddress

BYOIP publicIpAddress를 만들 때 IP 주소를 지정합니다.

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

-IpAddressVersion

IP 주소의 버전을 지정합니다.

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

-IpTag

IpTag 목록입니다.

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

-Location

공용 IP 주소를 만들 지역을 지정합니다.

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

-Name

이 cmdlet에서 만드는 공용 IP 주소의 이름을 지정합니다.

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

-PublicIpPrefix

공용 IP 주소를 할당할 PSPublicIpPrefix를 지정합니다.

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

-ResourceGroupName

공용 IP 주소를 만들 리소스 그룹의 이름을 지정합니다.

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

-ReverseFqdn

FQDN(정규화된 역방향 도메인 이름)을 지정합니다.

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

-Sku

공용 IP SKU 이름입니다.

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

-Tag

해시 테이블 형식의 키-값 쌍입니다. 예: @{key0="value0"; key1=$null; key2="value2"}

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

-Tier

공용 IP SKU 계층입니다.

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

-WhatIf

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

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

-Zone

리소스에 할당된 IP를 나타내는 가용성 영역의 목록입니다.

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

입력

String

PSPublicIpTag[]

PSPublicIpPrefix

Int32

String[]

Hashtable

출력

PSPublicIpAddress