New-AzDnsRecordSet

  • Başvuru
Modül:
Az.Dns

Bir DNS kayıt kümesi oluşturur.

Sözdizimi

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'i, belirtilen ada sahip yeni bir Etki Alanı Adı Sistemi (DNS) kayıt kümesi oluşturur ve belirtilen bölgeye yazın. RecordSet nesnesi, aynı ada ve türe sahip bir DNS kayıtları kümesidir. Adın tam ada değil bölgeye göre olduğunu unutmayın. DnsRecords parametresi, kayıt kümesindeki kayıtları belirtir. Bu parametre, New-AzDnsRecordConfig kullanılarak yapılandırılmış bir DNS kayıtları dizisi alır. İşlem hattı işlecini kullanarak bu cmdlet'e bir DnsZone nesnesi geçirebilir veya DnsZone nesnesini Zone parametresi olarak geçirebilir veya alternatif olarak bölgeyi ada göre belirtebilirsiniz. Cmdlet'in sizden onay isteyip istemediğinizi denetlemek için Confirm parametresini ve $ConfirmPreference Windows PowerShell değişkenini kullanabilirsiniz. Eşleşen bir RecordSet zaten varsa (aynı ad ve kayıt türü), Üzerine Yaz parametresini belirtmeniz gerekir, aksi takdirde cmdlet yeni bir RecordSet oluşturmaz.

Örnekler

Örnek 1: A türünde bir RecordSet oluşturma

$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

Bu örnek, bölge myzone.com www adlı bir RecordSet oluşturur. Kayıt kümesi A türündedir ve 1 saatlik (3600 saniye) bir TTL'ye sahiptir. Tek bir DNS kaydı içerir.

Örnek 2: AAAA türünde bir RecordSet oluşturma

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

Bu örnek, bölge myzone.com www adlı bir RecordSet oluşturur. Kayıt kümesi AAAA türündedir ve 1 saatlik (3600 saniye) bir TTL'ye sahiptir. Tek bir DNS kaydı içerir. Yalnızca bir pn_PowerShell_short satırı kullanarak bir RecordSet oluşturmak veya birden çok kayıt içeren bir kayıt kümesi oluşturmak için bkz. Örnek 1.

Örnek 3: CNAME türünde bir RecordSet oluşturma

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

Bu örnek, bölge myzone.com www adlı bir RecordSet oluşturur. Kayıt kümesi CNAME türündedir ve 1 saatlik (3600 saniye) bir TTL'ye sahiptir. Tek bir DNS kaydı içerir. Yalnızca bir pn_PowerShell_short satırı kullanarak bir RecordSet oluşturmak veya birden çok kayıt içeren bir kayıt kümesi oluşturmak için bkz. Örnek 1.

Örnek 4: MX türünde bir RecordSet oluşturma

$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

Bu komut, bölge myzone.com www adlı bir RecordSet oluşturur. Kayıt kümesi MX türündedir ve 1 saatlik (3600 saniye) bir TTL'ye sahiptir. Tek bir DNS kaydı içerir. Yalnızca bir pn_PowerShell_short satırı kullanarak bir RecordSet oluşturmak veya birden çok kayıt içeren bir kayıt kümesi oluşturmak için bkz. Örnek 1.

Örnek 5: NS türünde bir RecordSet oluşturma

$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

Bu komut, bölge myzone.com ns1 adlı bir RecordSet oluşturur. Kayıt kümesi NS türündedir ve 1 saatlik (3600 saniye) bir TTL'ye sahiptir. Tek bir DNS kaydı içerir. Yalnızca bir pn_PowerShell_short satırı kullanarak bir RecordSet oluşturmak veya birden çok kayıt içeren bir kayıt kümesi oluşturmak için bkz. Örnek 1.

Örnek 6: PTR türünde bir RecordSet oluşturma

$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

Bu komut, 3.2.1.in-addr.arpa bölgesinde 4 adlı bir RecordSet oluşturur. Kayıt kümesi PTR türündedir ve 1 saatlik (3600 saniye) bir TTL'ye sahiptir. Tek bir DNS kaydı içerir. Yalnızca bir pn_PowerShell_short satırı kullanarak bir RecordSet oluşturmak veya birden çok kayıt içeren bir kayıt kümesi oluşturmak için bkz. Örnek 1.

Örnek 7: SRV türünde bir RecordSet oluşturma

$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

Bu komut, bölge myzone.com _sip._tcp adlı bir RecordSet oluşturur. Kayıt kümesi SRV türündedir ve 1 saatlik (3600 saniye) bir TTL'ye sahiptir. 2001.2.3.4 IP adresine işaret eden tek bir DNS kaydı içerir. Hizmet (sip) ve protokol (tcp), kayıt verilerinin bir parçası olarak değil, kayıt kümesi adının bir parçası olarak belirtilir. Yalnızca bir pn_PowerShell_short satırı kullanarak bir RecordSet oluşturmak veya birden çok kayıt içeren bir kayıt kümesi oluşturmak için bkz. Örnek 1.

Örnek 8: TXT türünde bir RecordSet oluşturma

$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

Bu komut, bölge myzone.com metin adlı bir RecordSet oluşturur. Kayıt kümesi TXT türündedir ve 1 saatlik (3600 saniye) bir TTL'ye sahiptir. Tek bir DNS kaydı içerir. Yalnızca bir pn_PowerShell_short satırı kullanarak bir RecordSet oluşturmak veya birden çok kayıt içeren bir kayıt kümesi oluşturmak için bkz. Örnek 1.

Örnek 9: Bölge tepesinde RecordSet oluşturma

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

Bu komut, bölge myzone.com tepesinde (veya kökünde) bir RecordSet oluşturur. Bunu yapmak için, kayıt kümesi adı "@" (çift tırnaklar dahil) olarak belirtilir. Bir bölgenin tepesinde CNAME kayıtları oluşturamazsınız. Bu, DNS standartlarının bir kısıtlamasıdır; Bu, Azure DNS'nin bir sınırlaması değildir. Yalnızca bir pn_PowerShell_short satırı kullanarak bir RecordSet oluşturmak veya birden çok kayıt içeren bir kayıt kümesi oluşturmak için bkz. Örnek 1.

Örnek 10: Joker Karakter Kayıt Kümesi Oluşturma

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

Bu komut, bölge myzone.com * adlı bir RecordSet oluşturur. Bu bir joker karakter kayıt kümesidir. Yalnızca bir pn_PowerShell_short satırı kullanarak bir RecordSet oluşturmak veya birden çok kayıt içeren bir kayıt kümesi oluşturmak için bkz. Örnek 1.

Örnek 11: Boş kayıt kümesi oluşturma

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

Bu komut, bölge myzone.com www adlı bir RecordSet oluşturur. Kayıt kümesi A türündedir ve 1 saatlik (3600 saniye) bir TTL'ye sahiptir. Bu, daha sonra kayıt ekleyebileceğiniz bir yer tutucu işlevi gören boş bir kayıt kümesidir.

Örnek 12: Kayıt kümesi oluşturma ve tüm onayları gizleme

$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

Bu komut bir RecordSet oluşturur. Üzerine Yazma parametresi, bu kayıt kümesinin aynı ad ve türe sahip önceden var olan tüm kayıt kümelerinin üzerine yazılmasını sağlar (bu kayıt kümesindeki mevcut kayıtlar kaybolur). $False değerine sahip Confirm parametresi onay istemini gizler.

Parametreler

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik

Tür:IAzureContextContainer
Diğer adlar:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DnsRecords

Kayıt kümesine eklenecek DNS kayıtları dizisini belirtir. DNS kayıt nesneleri oluşturmak için New-AzDnsRecordConfig cmdlet'ini kullanabilirsiniz. Daha fazla bilgi için örneklere bakın.

Tür:DnsRecordBase[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Metadata

RecordSet ile ilişkilendirilecek meta veri dizisini belirtir. Meta veriler, karma tablo olarak temsil edilen ad-değer çiftleri kullanılarak belirtilir, örneğin @{"dept"="shopping";" env"="production"}.

Tür:Hashtable
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Name

Oluşturulacak RecordSet'in adını belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Overwrite

Bu cmdlet'in, zaten varsa belirtilen RecordSet'in üzerine yazdığını gösterir.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-RecordType

Oluşturulacak DNS kaydının türünü belirtir. Geçerli değerler:

  • A
  • AAAA
  • CNAME
  • MX
  • NS
  • PTR
  • SRV
  • TXT SOA kayıtları, bölge oluşturulduğunda otomatik olarak oluşturulur ve el ile oluşturulamaz.
Tür:RecordType
Kabul edilen değerler:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ResourceGroupName

DNS bölgesini içeren kaynak grubunu belirtir. Bölge adını belirtmek için ZoneName parametresini de belirtmeniz gerekir. Alternatif olarak, Bölge parametresini kullanarak bir DNS Bölgesi nesnesi geçirerek bölgeyi ve kaynak grubunu belirtebilirsiniz.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-TargetResourceId

Diğer Ad Hedef Kaynak Kimliği.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Ttl

DNS Kayıt Kümesi için Yaşam Süresi'ni (TTL) belirtir.

Tür:UInt32
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Zone

RecordSet'in oluşturulacağı DnsZone'u belirtir. Alternatif olarak, ZoneName ve ResourceGroupName parametrelerini kullanarak bölgeyi belirtebilirsiniz.

Tür:DnsZone
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ZoneName

RecordSet'in oluşturulacağı bölgenin adını belirtir. ResourceGroupName parametresini kullanarak bölgeyi içeren kaynak grubunu da belirtmeniz gerekir. Alternatif olarak, Bölge parametresini kullanarak bir DNS Bölgesi nesnesi geçirerek bölgeyi ve kaynak grubunu belirtebilirsiniz.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

Girişler

String

DnsZone

UInt32

RecordType

Hashtable

DnsRecordBase[]

Çıkışlar

DnsRecordSet

Notlar

Bu cmdlet'in sizden onay isteyip istemediğinizi denetlemek için Confirm parametresini kullanabilirsiniz. Varsayılan olarak, $ConfirmPreference Windows PowerShell değişkeni orta veya daha düşük bir değere sahipse cmdlet sizden onay ister. Onayla veya Onayla:$True belirtirseniz, bu cmdlet çalışmadan önce sizden onay ister. Confirm:$False belirtirseniz, cmdlet sizden onay istemez.