Megosztás a következőn keresztül:


New-AzDnsRecordSet

Létrehoz egy DNS-rekordkészletet.

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

A New-AzDnsRecordSet parancsmag létrehoz egy új dns-rekordhalmazt a megadott névvel és típussal a megadott zónában. A RecordSet objektum egy azonos nevű és típusú DNS-rekordkészlet. Vegye figyelembe, hogy a név a zónához képest van, nem pedig a teljes név. A DnsRecords paraméter határozza meg a rekordhalmaz rekordjait. Ez a paraméter a New-AzDnsRecordConfig használatával létrehozott DNS-rekordok tömbjére épül. A folyamatkezelővel átadhat egy DnsZone objektumot ennek a parancsmagnak, vagy átadhat egy DnsZone objektumot Zóna paraméterként, vagy megadhat egy zónát név szerint. A Confirm paraméter és $ConfirmPreference Windows PowerShell-változó használatával szabályozhatja, hogy a parancsmag megerősítést kér-e. Ha már létezik egy egyező RecordSet (ugyanaz a név és rekordtípus), meg kell adnia a Felülírás paramétert, ellenkező esetben a parancsmag nem hoz létre új RecordSet.

Példák

1. példa: A típusú RecordSet létrehozása

$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

Ez a példa létrehoz egy RecordSet nevű www a zóna myzone.com. A rekordhalmaz A típusú, és TTL értéke 1 óra (3600 másodperc). Egyetlen DNS-rekordot tartalmaz.

2. példa: AAAA típusú RecordSet létrehozása

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

Ez a példa létrehoz egy RecordSet nevű www a zóna myzone.com. A rekordhalmaz AAAA típusú, és TTL értéke 1 óra (3600 másodperc). Egyetlen DNS-rekordot tartalmaz. Ha RecordSet- csak egy sornyi pn_PowerShell_short szeretne létrehozni, vagy több rekordot tartalmazó rekordkészletet szeretne létrehozni, tekintse meg az 1. példát.

3. példa: CNAME típusú RecordSet létrehozása

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

Ez a példa létrehoz egy RecordSet nevű www a zóna myzone.com. A rekordhalmaz CNAME típusú, és TTL értéke 1 óra (3600 másodperc). Egyetlen DNS-rekordot tartalmaz. Ha RecordSet- csak egy sornyi pn_PowerShell_short szeretne létrehozni, vagy több rekordot tartalmazó rekordkészletet szeretne létrehozni, tekintse meg az 1. példát.

4. példa: MX típusú RecordSet létrehozása

$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

Ez a parancs létrehoz egy RecordSet nevű www a zóna myzone.com. A rekordhalmaz MX típusú, és TTL értéke 1 óra (3600 másodperc). Egyetlen DNS-rekordot tartalmaz. Ha RecordSet- csak egy sornyi pn_PowerShell_short szeretne létrehozni, vagy több rekordot tartalmazó rekordkészletet szeretne létrehozni, tekintse meg az 1. példát.

5. példa: NS típusú RecordS-halmaz létrehozása

$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

Ez a parancs létrehoz egy ns1 nevű RecordSet a zóna myzone.com. A rekordhalmaz NS típusú, és TTL értéke 1 óra (3600 másodperc). Egyetlen DNS-rekordot tartalmaz. Ha RecordSet- csak egy sornyi pn_PowerShell_short szeretne létrehozni, vagy több rekordot tartalmazó rekordkészletet szeretne létrehozni, tekintse meg az 1. példát.

6. példa: PTR típusú RecordSet létrehozása

$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

Ez a parancs létrehoz egy 4 nevű RecordSet a 3.2.1.in-addr.arpa zónában. A rekordhalmaz PTR típusú, és TTL értéke 1 óra (3600 másodperc). Egyetlen DNS-rekordot tartalmaz. Ha RecordSet- csak egy sornyi pn_PowerShell_short szeretne létrehozni, vagy több rekordot tartalmazó rekordkészletet szeretne létrehozni, tekintse meg az 1. példát.

7. példa: SRV típusú RecordSet létrehozása

$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

Ez a parancs létrehoz egy RecordSet nevű _sip._tcp a zóna myzone.com. A rekordhalmaz SRV típusú, és TTL értéke 1 óra (3600 másodperc). Egyetlen DNS-rekordot tartalmaz, amely a 2001.2.3.4 IP-címre mutat. A szolgáltatás (sip) és a protokoll (tcp) a rekordkészlet nevének részeként van megadva, nem a rekordadatok részeként. Ha RecordSet- csak egy sornyi pn_PowerShell_short szeretne létrehozni, vagy több rekordot tartalmazó rekordkészletet szeretne létrehozni, tekintse meg az 1. példát.

8. példa: TXT típusú RecordSet létrehozása

$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

Ez a parancs létrehoz egy RecordSet elnevezett szöveget a zóna myzone.com. A rekordhalmaz TXT típusú, és TTL értéke 1 óra (3600 másodperc). Egyetlen DNS-rekordot tartalmaz. Ha RecordSet- csak egy sornyi pn_PowerShell_short szeretne létrehozni, vagy több rekordot tartalmazó rekordkészletet szeretne létrehozni, tekintse meg az 1. példát.

9. példa: RecordSet létrehozása a zóna csúcsán

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

Ez a parancs létrehoz egy RecordSet a zóna csúcsánál (vagy gyökerénél) a myzone.com. Ehhez a rekordhalmaz neve "@" néven van megadva (beleértve a dupla idézőjeleket is). A zóna csúcsán nem hozhat létre CNAME rekordokat. Ez a DNS-szabványok korlátozása; ez nem az Azure DNS korlátozása. Ha RecordSet- csak egy sornyi pn_PowerShell_short szeretne létrehozni, vagy több rekordot tartalmazó rekordkészletet szeretne létrehozni, tekintse meg az 1. példát.

10. példa: Helyettesítő karakterek rekordkészletének létrehozása

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

Ez a parancs létrehoz egy RecordSet * néven a zóna myzone.com. Ez egy helyettesítő karakterkészlet. Ha RecordSet- csak egy sornyi pn_PowerShell_short szeretne létrehozni, vagy több rekordot tartalmazó rekordkészletet szeretne létrehozni, tekintse meg az 1. példát.

11. példa: Üres rekordkészlet létrehozása

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

Ez a parancs létrehoz egy RecordSet nevű www a zóna myzone.com. A rekordhalmaz A típusú, és TTL értéke 1 óra (3600 másodperc). Ez egy üres rekordkészlet, amely helyőrzőként működik, amelyhez később rekordokat adhat hozzá.

12. példa: Rekordhalmaz létrehozása és az összes megerősítés letiltása

$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

Ez a parancs létrehoz egy RecordSet. A Felülírás paraméter biztosítja, hogy ez a rekordkészlet felülírja az azonos nevű és típusú meglévő rekordhalmazokat (a rekordhalmaz meglévő rekordjai elvesznek). A Megerősítés paraméter $False értékkel letiltja a megerősítési kérést.

Paraméterek

-Confirm

Megerősítést kér a parancsmag futtatása előtt.

Típus:SwitchParameter
Aliasok:cf
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés

Típus:IAzureContextContainer
Aliasok:AzContext, AzureRmContext, AzureCredential
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-DnsRecords

Megadja a rekordhalmazba felvenni kívánt DNS-rekordok tömbét. A New-AzDnsRecordConfig parancsmaggal DNS-rekordobjektumokat hozhat létre. További információért tekintse meg a példákat.

Típus:DnsRecordBase[]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Metadata

A RecordSethez társítandó metaadatok tömbje. A metaadatok név-érték párok használatával vannak megadva, amelyek kivonattáblákként vannak ábrázolva, például @{"dept"="shopping";" env"="production"}.

Típus:Hashtable
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Name

Megadja a létrehozandó RecordSet nevét.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Overwrite

Azt jelzi, hogy ez a parancsmag felülírja a megadott RecordSet, ha már létezik.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-RecordType

Megadja a létrehozandó DNS-rekord típusát. Az érvényes értékek a következők:

  • Egy
  • AAAA
  • CNAME
  • MX
  • NAPTR
  • NS
  • PTR
  • SRV
  • A TXT SOA rekordok automatikusan jönnek létre a zóna létrehozásakor, és nem hozhatók létre manuálisan.
Típus:RecordType
Elfogadott értékek:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-ResourceGroupName

Megadja a DNS-zónát tartalmazó erőforráscsoportot. A zónanév megadásához meg kell adnia a ZoneName paramétert is. Másik lehetőségként megadhatja a zónát és az erőforráscsoportot úgy is, hogy egy DNS-zónaobjektumot a Zóna paraméterrel ad át.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-TargetResourceId

Alias célerőforrás-azonosító.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Ttl

Megadja a DNS RecordSet élettartamát (TTL).

Típus:UInt32
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.

Típus:SwitchParameter
Aliasok:wi
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Zone

Azt a DnsZone-t adja meg, amelyben létre kívánja hozni a RecordSet. Másik lehetőségként megadhatja a zónát a ZoneName és ResourceGroupName paraméterekkel.

Típus:DnsZone
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-ZoneName

Annak a zónának a nevét adja meg, amelyben létre kívánja hozni a RecordSet. A zónát tartalmazó erőforráscsoportot is meg kell adnia a ResourceGroupName paraméterrel. Másik lehetőségként megadhatja a zónát és az erőforráscsoportot úgy is, hogy egy DNS-zónaobjektumot a Zóna paraméterrel ad át.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

Bevitelek

Kimenetek

Jegyzetek

A Confirm paraméter használatával szabályozhatja, hogy a parancsmag megerősítést kér-e. Alapértelmezés szerint a parancsmag megerősítést kér, ha a $ConfirmPreference Windows PowerShell-változó közepes vagy alacsonyabb értékkel rendelkezik. Ha megadja Megerősítés vagy Confirm:$True, ez a parancsmag a futtatás előtt megerősítést kér. Ha Confirm:$Falseértéket adja meg, a parancsmag nem kéri a megerősítést.