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[]
출력
관련 링크
Azure PowerShell