다음을 통해 공유

New-AzDnsRecordSet

  • 참조
모듈:
Az.Dns

DNS 레코드 집합을 만듭니다.

구문

New-AzDnsRecordSet
   -Name <String>
   -ZoneName <String>
   -ResourceGroupName <String>
   -Ttl <UInt32>
   -RecordType <RecordType>
   [-Metadata <Hashtable>]
   [-DnsRecords <DnsRecordBase[]>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDnsRecordSet
   -Name <String>
   -ZoneName <String>
   -ResourceGroupName <String>
   [-Ttl <UInt32>]
   -RecordType <RecordType>
   -TargetResourceId <String>
   [-Metadata <Hashtable>]
   [-DnsRecords <DnsRecordBase[]>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDnsRecordSet
   -Name <String>
   -Zone <DnsZone>
   -Ttl <UInt32>
   -RecordType <RecordType>
   [-Metadata <Hashtable>]
   [-DnsRecords <DnsRecordBase[]>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDnsRecordSet
   -Name <String>
   -Zone <DnsZone>
   [-Ttl <UInt32>]
   -RecordType <RecordType>
   -TargetResourceId <String>
   [-Metadata <Hashtable>]
   [-DnsRecords <DnsRecordBase[]>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

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

예제

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

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

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

$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords (New-AzDnsRecordConfig -IPv4Address 1.2.3.4)

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

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

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

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

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

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

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

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

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

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

$Records = @()
$Records += New-AzDnsRecordConfig -Exchange "mail.microsoft.com" -Preference 5
$RecordSet = New-AzDnsRecordSet -Name "mail" -RecordType MX -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

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

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

$Records = @()
$Records += New-AzDnsRecordConfig -Nsdname ns1-01.azure-dns.com
$RecordSet = New-AzDnsRecordSet -Name "ns1" -RecordType NS -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

매개 변수

-Confirm

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

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

-DefaultProfile

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

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

-DnsRecords

레코드 집합에 포함할 DNS 레코드의 배열을 지정합니다. New-AzDnsRecordConfig cmdlet을 사용하여 DNS 레코드 개체를 만들 수 있습니다. 자세한 내용은 예제를 참조하세요.

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

-Metadata

RecordSet과 연결할 메타데이터의 배열을 지정합니다. 메타데이터는 해시 테이블로 표현되는 이름-값 쌍(예: @{"dept"="shopping";;")을 사용하여 지정됩니다. env"="production"}.

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

-Name

만들 RecordSet 이름을 지정합니다.

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

-Overwrite

이 cmdlet이 이미 있는 경우 지정된 RecordSet 덮어씁니다.

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

-RecordType

만들 DNS 레코드의 형식을 지정합니다. 유효한 값은 다음과 같습니다.

  • A
  • AAAA
  • CNAME
  • MX
  • NAPTR
  • NS
  • PTR
  • SRV
  • TXT SOA 레코드는 영역을 만들 때 자동으로 만들어지고 수동으로 만들 수 없습니다.
형식:RecordType
허용되는 값:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ResourceGroupName

DNS 영역을 포함하는 리소스 그룹을 지정합니다. 영역 이름을 지정하려면 ZoneName 매개 변수도 지정해야 합니다. 또는 Zone 매개 변수를 사용하여 DNS 영역 개체를 전달하여 영역 및 리소스 그룹을 지정할 수 있습니다.

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

-TargetResourceId

별칭 대상 리소스 ID입니다.

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

-Ttl

DNS RecordSet의 TTL(Time to Live)을 지정합니다.

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

-WhatIf

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

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

-Zone

RecordSet만들 DnsZone을 지정합니다. 또는 ZoneName 및 ResourceGroupName 매개 변수를 사용하여 영역을 지정할 수 있습니다.

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

-ZoneName

RecordSet만들 영역의 이름을 지정합니다. 또한 ResourceGroupName 매개 변수를 사용하여 영역이 포함된 리소스 그룹을 지정해야 합니다. 또는 Zone 매개 변수를 사용하여 DNS 영역 개체를 전달하여 영역 및 리소스 그룹을 지정할 수 있습니다.

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

입력

String

DnsZone

UInt32

RecordType

Hashtable

DnsRecordBase[]

출력

DnsRecordSet

참고

Confirm 매개 변수를 사용하여 이 cmdlet에서 확인을 요청하는지 여부를 제어할 수 있습니다. 기본적으로 cmdlet은 $ConfirmPreference Windows PowerShell 변수의 값이 중간 이하인지 확인하라는 메시지를 표시합니다. 확인 또는 confirm:$True지정하는 경우 이 cmdlet은 실행하기 전에 확인 메시지를 표시합니다. Confirm:$False지정하는 경우 cmdlet에서 확인 메시지를 표시하지 않습니다.