New-AzPrivateDnsRecordSet

참조

모듈:: Az.PrivateDns

프라이빗 DNS 영역에 레코드 집합을 만듭니다.

구문

New-AzPrivateDnsRecordSet
   -ResourceGroupName <String>
   -ZoneName <String>
   -Name <String>
   -RecordType <RecordType>
   -Ttl <UInt32>
   [-Metadata <Hashtable>]
   [-PrivateDnsRecord <PSPrivateDnsRecordBase[]>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzPrivateDnsRecordSet
   -Zone <PSPrivateDnsZone>
   -Name <String>
   -RecordType <RecordType>
   -Ttl <UInt32>
   [-Metadata <Hashtable>]
   [-PrivateDnsRecord <PSPrivateDnsRecordBase[]>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzPrivateDnsRecordSet
   -ParentResourceId <String>
   -Name <String>
   -RecordType <RecordType>
   -Ttl <UInt32>
   [-Metadata <Hashtable>]
   [-PrivateDnsRecord <PSPrivateDnsRecordBase[]>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-AzPrivateDnsRecordSet cmdlet은 지정된 프라이빗 영역에 지정된 이름 및 형식을 사용하여 새 DNS(Private Domain Name System) 레코드 집합을 만듭니다. RecordSet 개체는 이름과 형식이 같은 프라이빗 DNS 레코드 집합입니다. 이름은 정규화된 이름이 아니라 프라이빗 영역을 기준으로 합니다. PrivateDnsRecord 매개 변수는 레코드 집합의 레코드를 지정합니다. 이 매개 변수는 New-AzPrivateDnsRecordConfig를 사용하여 생성된 프라이빗 DNS 레코드의 배열을 사용합니다. 파이프라인 연산자를 사용하여 PSPrivateDnsZone 개체를 이 cmdlet에 전달하거나 PSPrivateDnsZone 개체를 영역 매개 변수로 전달하거나 ResourceId로 영역을 지정하거나 이름으로 영역을 지정할 수 있습니다. Confirm 매개 변수 및 $ConfirmPreference Windows PowerShell 변수를 사용하여 cmdlet에서 확인을 요청하는지 여부를 제어할 수 있습니다. 일치하는 RecordSet(동일한 이름 및 레코드 형식)이 이미 있는 경우 덮어쓰기 매개 변수를 지정해야 합니다. 그렇지 않으면 cmdlet이 새 RecordSet을 만들지 않습니다.

예제

예제 1: A 형식의 RecordSet 만들기

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -IPv4Address 1.2.3.4
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

# When creating a RecordSet containing a single record, the above sequence can also be condensed into a single line:

$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords (New-AzPrivateDnsRecordConfig -IPv4Address 1.2.3.4)

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/providers/Microsoft.Netwo
                    rk/privateDnsZones/myzone.com/A/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {1.2.3.4}
Metadata          :
IsAutoRegistered  :


# To create a record set containing multiple records, use New-AzPrivateDnsRecordConfig to add each record to the $Records array,
# then call New-AzPrivateDnsRecordSet, as follows:

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -IPv4Address 1.2.3.4
$Records += New-AzPrivateDnsRecordConfig -IPv4Address 5.6.7.8
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/providers/Microsoft.Netwo
                    rk/privateDnsZones/myzone.com/A/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {1.2.3.4, 5.6.7.8}
Metadata          :
IsAutoRegistered  :

다음은 프라이빗 영역 myzone.com www라는 RecordSet을 만드는 예제입니다. 레코드 집합은 A 형식이며 TTL은 1시간(3600초)입니다. 단일 프라이빗 DNS 레코드를 포함합니다.

예제 2: AAAA 형식의 RecordSet 만들기

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Ipv6Address 2001:db8::1
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType AAAA -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/AAAA/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : AAAA
Records           : {2001:db8::1}
Metadata          :
IsAutoRegistered  :

다음은 프라이빗 영역 myzone.com www라는 RecordSet을 만드는 예제입니다. 레코드 집합은 AAAA 형식이며 TTL은 1시간(3600초)입니다. 단일 프라이빗 DNS 레코드를 포함합니다. 한 줄의 pn_PowerShell_short 사용하여 RecordSet을 만들거나 여러 레코드가 있는 레코드 집합을 만들려면 예제 1을 참조하세요.

예제 3: CNAME 형식의 RecordSet 만들기

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Cname www.contoso.com
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType CNAME -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/CNAME/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : CNAME
Records           : {www.contoso.com}
Metadata          :
IsAutoRegistered  :

다음은 프라이빗 영역 myzone.com www라는 RecordSet을 만드는 예제입니다. 레코드 집합은 CNAME 형식이며 TTL은 1시간(3600초)입니다. 단일 프라이빗 DNS 레코드를 포함합니다. 한 줄의 pn_PowerShell_short 사용하여 RecordSet을 만들거나 여러 레코드가 있는 레코드 집합을 만들려면 예제 1을 참조하세요.

예제 4: MX 형식의 RecordSet 만들기

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Exchange "mail.microsoft.com" -Preference 5
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType MX -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/MX/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : MX
Records           : {[5,mail.microsoft.com]}
Metadata          :
IsAutoRegistered  :

이 명령은 프라이빗 영역 myzone.com www라는 RecordSet을 만듭니다. 레코드 집합은 MX 형식이며 TTL은 1시간(3600초)입니다. 단일 프라이빗 DNS 레코드를 포함합니다. 한 줄의 pn_PowerShell_short 사용하여 RecordSet을 만들거나 여러 레코드가 있는 레코드 집합을 만들려면 예제 1을 참조하세요.

예제 5: PTR 형식의 RecordSet 만들기

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Ptrdname www.contoso.com
$RecordSet = New-AzPrivateDnsRecordSet -Name "4" -RecordType PTR -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "3.2.1.in-addr.arpa" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/3.2.1.in-addr.arpa/PTR/4
Name              : 4
ZoneName          : 3.2.1.in-addr.arpa
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : PTR
Records           : {www.contoso.com}
Metadata          :
IsAutoRegistered  :

이 명령은 프라이빗 영역 3.2.1.in-addr.arpa에 4라는 RecordSet을 만듭니다. 레코드 집합은 PTR 형식이며 TTL은 1시간(3600초)입니다. 단일 프라이빗 DNS 레코드를 포함합니다. 한 줄의 pn_PowerShell_short 사용하여 RecordSet을 만들거나 여러 레코드가 있는 레코드 집합을 만들려면 예제 1을 참조하세요.

예제 6: SRV 형식의 RecordSet 만들기

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Priority 0 -Weight 5 -Port 8080 -Target sipservice.contoso.com
$RecordSet = New-AzPrivateDnsRecordSet -Name "_sip._tcp" -RecordType SRV -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/SRV/_sip._tcp
Name              : _sip._tcp
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : SRV
Records           : {[0,5,8080,sipservice.contoso.com]}
Metadata          :
IsAutoRegistered  :

이 명령은 프라이빗 영역 myzone.com _sip._tcp라는 RecordSet을 만듭니다. 레코드 집합은 SRV 형식이며 TTL은 1시간(3600초)입니다. IP 주소 2001.2.3.4를 가리키는 단일 프라이빗 DNS 레코드를 포함합니다. 서비스(sip) 및 프로토콜(tcp)은 레코드 데이터의 일부가 아니라 레코드 집합 이름의 일부로 지정됩니다. 한 줄의 pn_PowerShell_short 사용하여 RecordSet을 만들거나 여러 레코드가 있는 레코드 집합을 만들려면 예제 1을 참조하세요.

예제 7: TXT 형식의 RecordSet 만들기

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Value "This is a TXT Record"
$RecordSet = New-AzPrivateDnsRecordSet -Name "text" -RecordType TXT -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/TXT/text
Name              : text
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : TXT
Records           : {This is a TXT Record}
Metadata          :
IsAutoRegistered  :

이 명령은 프라이빗 영역 myzone.com 이름이 지정된 RecordSet 텍스트를 만듭니다. 레코드 집합은 TXT 형식이며 TTL은 1시간(3600초)입니다. 단일 프라이빗 DNS 레코드를 포함합니다. 한 줄의 pn_PowerShell_short 사용하여 RecordSet을 만들거나 여러 레코드가 있는 레코드 집합을 만들려면 예제 1을 참조하세요.

예제 8: 영역 루트에서 RecordSet 만들기

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Ipv4Address 1.2.3.4
$RecordSet = New-AzPrivateDnsRecordSet -Name "@" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/A/@
Name              : @
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {1.2.3.4}
Metadata          :
IsAutoRegistered  :

이 명령은 프라이빗 영역 myzone.com 루트(또는 루트)에 RecordSet을 만듭니다. 이렇게 하려면 레코드 집합 이름이 "@"(큰따옴표 포함)로 지정됩니다. 영역의 루트에 CNAME 레코드를 만들 수 없습니다. DNS 표준의 제약 조건입니다. Azure 프라이빗 DNS의 제한은 아닙니다. 한 줄의 pn_PowerShell_short 사용하여 RecordSet을 만들거나 여러 레코드가 있는 레코드 집합을 만들려면 예제 1을 참조하세요.

예제 9: 와일드카드 레코드 집합 만들기

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Ipv4Address 1.2.3.4
$RecordSet = New-AzPrivateDnsRecordSet -Name "*" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/A/@
Name              : *
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {1.2.3.4}
Metadata          :
IsAutoRegistered  :

이 명령은 프라이빗 영역 myzone.com *라는 RecordSet을 만듭니다. 와일드카드 레코드 집합입니다. 한 줄의 pn_PowerShell_short 사용하여 RecordSet을 만들거나 여러 레코드가 있는 레코드 집합을 만들려면 예제 1을 참조하세요.

예제 10: 빈 레코드 집합 만들기

$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords @()

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/A/@
Name              : *
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {}
Metadata          :
IsAutoRegistered  :

이 명령은 프라이빗 영역 myzone.com *라는 RecordSet을 만듭니다. 레코드 집합은 A 형식이며 TTL은 1시간(3600초)입니다. 나중에 레코드를 추가할 수 있는 자리 표시자 역할을 하는 빈 레코드 집합입니다.

예제 11: 레코드 집합 만들기 및 모든 확인 표시 안 함

$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords (New-AzDnsRecordConfig -Ipv4Address 1.2.3.4) -Confirm:$False -Overwrite

이 명령은 RecordSet을 만듭니다. 덮어쓰기 매개 변수를 사용하면 이 레코드 집합이 이름과 형식이 같은 기존 레코드 집합을 덮어씁니다(해당 레코드 집합의 기존 레코드가 손실됨). 값이 $False 있는 Confirm 매개 변수는 확인 프롬프트를 표시하지 않습니다.

매개 변수

-Confirm

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

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

-DefaultProfile

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

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

-Metadata

리소스 태그를 나타내는 해시 테이블입니다.

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

-Name

이 레코드 집합에 있는 레코드의 이름입니다(영역 이름을 기준으로 하며 종료 점이 없는 경우).

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

-Overwrite

레코드 집합이 이미 있는 경우 실패하지 마세요.

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

-ParentResourceId

프라이빗 DNS 영역 ResourceID.

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

-PrivateDnsRecord

이 레코드 집합의 일부인 프라이빗 dns 레코드입니다.

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

-RecordType

이 레코드 집합의 프라이빗 DNS 레코드 형식입니다.

형식:	RecordType
허용되는 값:	A, AAAA, CNAME, MX, PTR, SOA, SRV, TXT
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ResourceGroupName

영역이 속한 리소스 그룹입니다.

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

-Ttl

이 레코드 집합에 있는 모든 레코드의 TTL 값입니다.

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

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

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

-Zone

레코드 집합을 만들 영역을 나타내는 PrivateDnsZone 개체입니다.

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

-ZoneName

레코드 집합을 만들 영역입니다(종료 점 제외).

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

입력

PSPrivateDnsZone

String

출력

PSPrivateDnsRecordSet

다음을 통해 공유