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.