New-AzDnsRecordSet

Referensi

Modul:: Az.Dns

Membuat kumpulan catatan DNS.

Sintaks

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>]

Deskripsi

Cmdlet New-AzDnsRecordSet membuat kumpulan catatan Sistem Nama Domain (DNS) baru dengan nama dan jenis yang ditentukan di zona yang ditentukan. Objek RecordSet adalah sekumpulan catatan DNS dengan nama dan jenis yang sama. Perhatikan bahwa namanya relatif terhadap zona dan bukan nama yang sepenuhnya memenuhi syarat. Parameter DnsRecords menentukan rekaman dalam kumpulan catatan. Parameter ini mengambil array rekaman DNS, dibangun menggunakan New-AzDnsRecordConfig. Anda dapat menggunakan operator alur untuk meneruskan objek DnsZone ke cmdlet ini, atau Anda dapat meneruskan objek DnsZone sebagai parameter Zona , atau atau Anda dapat menentukan zona berdasarkan nama. Anda dapat menggunakan parameter Konfirmasi dan $ConfirmPreference variabel Windows PowerShell untuk mengontrol apakah cmdlet meminta konfirmasi. Jika RecordSet yang cocok sudah ada (nama dan jenis rekaman yang sama), Anda harus menentukan parameter Timpa, jika tidak cmdlet tidak akan membuat RecordSet baru.

Contoh

Contoh 1: Membuat RecordSet tipe A

$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

Contoh ini membuat RecordSet bernama www di zona myzone.com. Kumpulan catatan berjenis A dan memiliki TTL 1 jam (3600 detik). Ini berisi satu catatan DNS.

Contoh 2: Membuat RecordSet jenis AAAA

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

Contoh ini membuat RecordSet bernama www di zona myzone.com. Kumpulan catatan berjenis AAAA dan memiliki TTL 1 jam (3600 detik). Ini berisi satu catatan DNS. Untuk membuat RecordSet hanya menggunakan satu baris pn_PowerShell_short, atau untuk membuat kumpulan catatan dengan beberapa rekaman, lihat Contoh 1.

Contoh 3: Membuat RecordSet jenis CNAME

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

Contoh ini membuat RecordSet bernama www di zona myzone.com. Kumpulan catatan berjenis CNAME dan memiliki TTL 1 jam (3600 detik). Ini berisi satu catatan DNS. Untuk membuat RecordSet hanya menggunakan satu baris pn_PowerShell_short, atau untuk membuat kumpulan catatan dengan beberapa rekaman, lihat Contoh 1.

Contoh 4: Membuat RecordSet jenis MX

$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

Perintah ini membuat RecordSet bernama www di zona myzone.com. Kumpulan catatan berjenis MX dan memiliki TTL 1 jam (3600 detik). Ini berisi satu catatan DNS. Untuk membuat RecordSet hanya menggunakan satu baris pn_PowerShell_short, atau untuk membuat kumpulan catatan dengan beberapa rekaman, lihat Contoh 1.

Contoh 5: Membuat RecordSet jenis NS

$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

Perintah ini membuat RecordSet bernama ns1 di zona myzone.com. Kumpulan catatan berjenis NS dan memiliki TTL 1 jam (3600 detik). Ini berisi satu catatan DNS. Untuk membuat RecordSet hanya menggunakan satu baris pn_PowerShell_short, atau untuk membuat kumpulan catatan dengan beberapa rekaman, lihat Contoh 1.

Contoh 6: Membuat RecordSet jenis PTR

$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

Perintah ini membuat RecordSet bernama 4 di zona 3.2.1.in-addr.arpa. Kumpulan catatan berjenis PTR dan memiliki TTL 1 jam (3600 detik). Ini berisi satu catatan DNS. Untuk membuat RecordSet hanya menggunakan satu baris pn_PowerShell_short, atau untuk membuat kumpulan catatan dengan beberapa rekaman, lihat Contoh 1.

Contoh 7: Membuat RecordSet jenis SRV

$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

Perintah ini membuat RecordSet bernama _sip._tcp di zona myzone.com. Kumpulan catatan berjenis SRV dan memiliki TTL 1 jam (3600 detik). Ini berisi satu catatan DNS, menunjuk ke alamat IP 2001.2.3.4. Layanan (sip) dan protokol (tcp) ditentukan sebagai bagian dari nama kumpulan catatan, bukan sebagai bagian dari data rekaman. Untuk membuat RecordSet hanya menggunakan satu baris pn_PowerShell_short, atau untuk membuat kumpulan catatan dengan beberapa rekaman, lihat Contoh 1.

Contoh 8: Membuat RecordSet jenis TXT

$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

Perintah ini membuat recordSet bernama text di zona myzone.com. Kumpulan catatan berjenis TXT dan memiliki TTL 1 jam (3600 detik). Ini berisi satu catatan DNS. Untuk membuat RecordSet hanya menggunakan satu baris pn_PowerShell_short, atau untuk membuat kumpulan catatan dengan beberapa rekaman, lihat Contoh 1.

Contoh 9: Membuat RecordSet di puncak zona

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

Perintah ini membuat RecordSet di puncak (atau akar) zona myzone.com. Untuk melakukan ini, nama kumpulan catatan ditentukan sebagai "@" (termasuk tanda kutip ganda). Anda tidak dapat membuat rekaman CNAME di puncak zona. Ini adalah batasan standar DNS; ini bukan batasan Azure DNS. Untuk membuat RecordSet hanya menggunakan satu baris pn_PowerShell_short, atau untuk membuat kumpulan catatan dengan beberapa rekaman, lihat Contoh 1.

Contoh 10: Membuat Kumpulan Catatan kartubebas

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

Perintah ini membuat RecordSet bernama * di zona myzone.com. Ini adalah kumpulan catatan kartubebas. Untuk membuat RecordSet hanya menggunakan satu baris pn_PowerShell_short, atau untuk membuat kumpulan catatan dengan beberapa rekaman, lihat Contoh 1.

Contoh 11: Membuat kumpulan catatan kosong

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

Perintah ini membuat RecordSet bernama www di zona myzone.com. Kumpulan catatan berjenis A dan memiliki TTL 1 jam (3600 detik). Ini adalah kumpulan catatan kosong, yang bertindak sebagai tempat penampung tempat Anda nanti bisa menambahkan rekaman.

Contoh 12: Buat kumpulan catatan dan tekan semua konfirmasi

$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

Perintah ini membuat RecordSet. Parameter Timpa memastikan bahwa kumpulan catatan ini menimpa kumpulan catatan yang sudah ada sebelumnya dengan nama dan jenis yang sama (rekaman yang ada dalam kumpulan catatan tersebut hilang). Parameter Konfirmasi dengan nilai $False menekan prompt konfirmasi.

Parameter

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan azure

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DnsRecords

Menentukan array rekaman DNS untuk disertakan dalam kumpulan catatan. Anda dapat menggunakan cmdlet New-AzDnsRecordConfig untuk membuat objek rekaman DNS. Lihat contoh untuk informasi selengkapnya.

Type:	DnsRecordBase[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Metadata

Menentukan array metadata untuk dikaitkan dengan RecordSet. Metadata ditentukan menggunakan pasangan nama-nilai yang direpresentasikan sebagai tabel hash, misalnya @{"dept"="shopping";" env"="production"}.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Menentukan nama RecordSet yang akan dibuat.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Overwrite

Menunjukkan bahwa cmdlet ini menimpa RecordSet yang ditentukan jika sudah ada.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RecordType

Menentukan tipe catatan DNS yang akan dibuat. Nilai yang valid adalah:

A
AAAA
CNAME
MX
NS
PTR
SRV
Rekaman SOA TXT dibuat secara otomatis saat zona dibuat dan tidak dapat dibuat secara manual.

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

Menentukan grup sumber daya yang berisi zona DNS. Anda juga harus menentukan parameter ZoneName untuk menentukan nama zona. Atau, Anda dapat menentukan zona dan grup sumber daya dengan meneruskan objek Zona DNS menggunakan parameter Zona .

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-TargetResourceId

Id Sumber Daya Target Alias.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Ttl

Menentukan Time to Live (TTL) untuk RecordSet DNS.

Type:	UInt32
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Zone

Menentukan DnsZone untuk membuat RecordSet. Atau, Anda dapat menentukan zona menggunakan parameter ZoneName dan ResourceGroupName .

Type:	DnsZone
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ZoneName

Menentukan nama zona untuk membuat RecordSet. Anda juga harus menentukan grup sumber daya yang berisi zona menggunakan parameter ResourceGroupName . Atau, Anda dapat menentukan zona dan grup sumber daya dengan meneruskan objek Zona DNS menggunakan parameter Zona .

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

Input

String

DnsZone

UInt32

RecordType

Hashtable

DnsRecordBase[]

Output

DnsRecordSet

Catatan

Anda dapat menggunakan parameter Konfirmasi untuk mengontrol apakah cmdlet ini meminta konfirmasi kepada Anda. Secara default, cmdlet meminta konfirmasi kepada Anda jika variabel $ConfirmPreference Windows PowerShell memiliki nilai Sedang atau lebih rendah. Jika Anda menentukan Konfirmasi atau Konfirmasi:$True, cmdlet ini akan meminta konfirmasi sebelum dijalankan. Jika Anda menentukan Confirm:$False, cmdlet tidak meminta konfirmasi kepada Anda.