New-AzDnsRecordSet
DNS 레코드 집합을 만듭니다.
Syntax
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(Do기본 Name System) 레코드 집합을 만듭니다. RecordSet 개체는 이름과 형식이 같은 DNS 레코드 집합입니다. 이름은 정규화된 이름이 아니라 영역을 기준으로 합니다. DnsRecords 매개 변수는 레코드 집합의 레코드를 지정합니다. 이 매개 변수는 New-AzDnsRecordConfig를 사용하여 생성된 DNS 레코드의 배열을 사용합니다. 파이프라인 연산자를 사용하여 DnsZone 개체를 이 cmdlet에 전달하거나 DnsZone 개체를 영역 매개 변수로 전달하거나 이름으로 영역을 지정할 수 있습니다. 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: wild카드 레코드 집합 만들기
$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 매개 변수는 확인 프롬프트를 표시하지 않습니다.
매개 변수
-Confirm
cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DnsRecords
레코드 집합에 포함할 DNS 레코드의 배열을 지정합니다. New-AzDnsRecordConfig cmdlet을 사용하여 DNS 레코드 개체를 만들 수 있습니다. 자세한 내용은 예제를 참조하세요.
| Type: | DnsRecordBase[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Metadata
RecordSet과 연결할 메타데이터의 배열을 지정합니다. 메타데이터는 해시 테이블로 표현되는 이름-값 쌍(예: @{"dept"="shopping";;")을 사용하여 지정됩니다. env"="production"}.
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
만들 RecordSet의 이름을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Overwrite
이 cmdlet이 이미 있는 경우 지정된 RecordSet 을 덮어씁니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RecordType
만들 DNS 레코드의 형식을 지정합니다. 유효한 값은 다음과 같습니다.
- A
- AAAA
- CNAME
- MX
- NS
- PTR
- SRV
- TXT SOA 레코드는 영역을 만들 때 자동으로 만들어지고 수동으로 만들 수 없습니다.
| Type: | RecordType |
| Accepted values: | A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourceGroupName
DNS 영역을 포함하는 리소스 그룹을 지정합니다. 영역 이름을 지정 하려면 ZoneName 매개 변수도 지정해야 합니다. 또는 영역 매개 변수를 사용하여 DNS 영역 개체를 전달하여 영역 및 리소스 그룹을 지정할 수 있습니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TargetResourceId
별칭 대상 리소스 ID입니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Ttl
DNS RecordSet의 TTL(Time to Live)을 지정합니다.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Zone
RecordSet을 만들 DnsZone을 지정합니다. 또는 ZoneName 및 ResourceGroupName 매개 변수를 사용하여 영역을 지정할 수 있습니다.
| Type: | DnsZone |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ZoneName
RecordSet을 만들 영역의 이름을 지정합니다. ResourceGroupName 매개 변수를 사용하여 영역이 포함된 리소스 그룹도 지정해야 합니다. 또는 영역 매개 변수를 사용하여 DNS 영역 개체를 전달하여 영역 및 리소스 그룹을 지정할 수 있습니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
입력
출력
참고
Confirm 매개 변수를 사용하여 이 cmdlet에서 확인을 요청하는지 여부를 제어할 수 있습니다. 기본적으로 cmdlet은 $ConfirmPreference Windows PowerShell 변수의 값이 중간 이하인지 확인하라는 메시지를 표시합니다. Confirm 또는 Confirm:$True 지정하는 경우 이 cmdlet은 실행하기 전에 확인 메시지를 표시합니다. Confirm:$False 지정하면 cmdlet에서 확인 메시지를 표시하지 않습니다.
관련 링크
Azure PowerShell
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기