New-AzPrivateDnsRecordSet
Létrehoz egy rekordhalmazt egy saját DNS zónában.
Syntax
New-AzPrivateDnsRecordSet
-ResourceGroupName <String>
-ZoneName <String>
-Name <String>
-RecordType <RecordType>
-Ttl <UInt32>
[-Metadata <Hashtable>]
[-PrivateDnsRecord <PSPrivateDnsRecordBase[]>]
[-Overwrite]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzPrivateDnsRecordSet
-Zone <PSPrivateDnsZone>
-Name <String>
-RecordType <RecordType>
-Ttl <UInt32>
[-Metadata <Hashtable>]
[-PrivateDnsRecord <PSPrivateDnsRecordBase[]>]
[-Overwrite]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzPrivateDnsRecordSet
-ParentResourceId <String>
-Name <String>
-RecordType <RecordType>
-Ttl <UInt32>
[-Metadata <Hashtable>]
[-PrivateDnsRecord <PSPrivateDnsRecordBase[]>]
[-Overwrite]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
A New-AzPrivateDnsRecordSet parancsmag létrehoz egy új dns-rekordot a megadott névvel és típussal a megadott privát zónában. A RecordSet-objektumok saját DNS azonos nevű és típusú rekordok. Vegye figyelembe, hogy a név a privát zónához képest van, nem pedig a teljes név. A PrivateDnsRecord paraméter a rekordhalmaz rekordjait határozza meg. Ez a paraméter a New-AzPrivateDnsRecordConfig használatával létrehozott saját DNS rekordok tömbje. A folyamatkezelővel átadhat egy PSPrivateDnsZone objektumot ennek a parancsmagnak, vagy átadhat egy PSPrivateDnsZone objektumot zónaparaméterként, vagy megadhatja a zónát a ResourceId alapján, vagy megadható a zóna neve alapján is. A Megerősítés 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 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 RecordSetet.
Példák
1. példa: A típusú RecordSet létrehozása
$Records = @()
$Records += New-AzPrivateDnsRecordConfig -IPv4Address 1.2.3.4
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records
# When creating a RecordSet containing a single record, the above sequence can also be condensed into a single line:
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords (New-AzPrivateDnsRecordConfig -IPv4Address 1.2.3.4)
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/providers/Microsoft.Netwo
rk/privateDnsZones/myzone.com/A/www
Name : www
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : A
Records : {1.2.3.4}
Metadata :
IsAutoRegistered :
# To create a record set containing multiple records, use New-AzPrivateDnsRecordConfig to add each record to the $Records array,
# then call New-AzPrivateDnsRecordSet, as follows:
$Records = @()
$Records += New-AzPrivateDnsRecordConfig -IPv4Address 1.2.3.4
$Records += New-AzPrivateDnsRecordConfig -IPv4Address 5.6.7.8
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/providers/Microsoft.Netwo
rk/privateDnsZones/myzone.com/A/www
Name : www
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : A
Records : {1.2.3.4, 5.6.7.8}
Metadata :
IsAutoRegistered :
Ez a példa létrehoz egy www nevű RecordSetet a privát zónában myzone.com. A rekordhalmaz A típusú, és TTL értéke 1 óra (3600 másodperc). Egyetlen saját DNS rekordot tartalmaz.
2. példa: AAAA típusú RecordSet létrehozása
$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Ipv6Address 2001:db8::1
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType AAAA -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/myzone.com/AAAA/www
Name : www
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : AAAA
Records : {2001:db8::1}
Metadata :
IsAutoRegistered :
Ez a példa létrehoz egy www nevű RecordSetet a privát zónában myzone.com. A rekordhalmaz AAAA típusú, és TTL értéke 1 óra (3600 másodperc). Egyetlen saját DNS rekordot tartalmaz. Ha csak egy sornyi pn_PowerShell_short szeretne rekordhalmazt létrehozni, vagy több rekordot tartalmazó rekordhalmazt szeretne létrehozni, tekintse meg az 1. példát.
3. példa: CNAME típusú RecordSet létrehozása
$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Cname www.contoso.com
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType CNAME -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/myzone.com/CNAME/www
Name : www
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : CNAME
Records : {www.contoso.com}
Metadata :
IsAutoRegistered :
Ez a példa létrehoz egy www nevű RecordSetet a privát zónában myzone.com. A rekordhalmaz CNAME típusú, és TTL értéke 1 óra (3600 másodperc). Egyetlen saját DNS rekordot tartalmaz. Ha csak egy sornyi pn_PowerShell_short szeretne rekordhalmazt létrehozni, vagy több rekordot tartalmazó rekordhalmazt szeretne létrehozni, tekintse meg az 1. példát.
4. példa: MX típusú RecordSet létrehozása
$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Exchange "mail.microsoft.com" -Preference 5
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType MX -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/myzone.com/MX/www
Name : www
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : MX
Records : {[5,mail.microsoft.com]}
Metadata :
IsAutoRegistered :
Ez a parancs létrehoz egy www nevű RecordSetet a privát zónában myzone.com. A rekordhalmaz MX típusú, és TTL értéke 1 óra (3600 másodperc). Egyetlen saját DNS rekordot tartalmaz. Ha csak egy sornyi pn_PowerShell_short szeretne rekordhalmazt létrehozni, vagy több rekordot tartalmazó rekordhalmazt szeretne létrehozni, tekintse meg az 1. példát.
5. példa: PTR típusú RecordSet létrehozása
$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Ptrdname www.contoso.com
$RecordSet = New-AzPrivateDnsRecordSet -Name "4" -RecordType PTR -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "3.2.1.in-addr.arpa" -PrivateDnsRecords $Records
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/3.2.1.in-addr.arpa/PTR/4
Name : 4
ZoneName : 3.2.1.in-addr.arpa
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : PTR
Records : {www.contoso.com}
Metadata :
IsAutoRegistered :
Ez a parancs létrehoz egy 4. nevű RecordSetet a 3.2.1.in-addr.arpa privát zónában. A rekordhalmaz PTR típusú, és TTL értéke 1 óra (3600 másodperc). Egyetlen saját DNS rekordot tartalmaz. Ha csak egy sornyi pn_PowerShell_short szeretne rekordhalmazt létrehozni, vagy több rekordot tartalmazó rekordhalmazt szeretne létrehozni, tekintse meg az 1. példát.
6. példa: SRV típusú RecordSet létrehozása
$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Priority 0 -Weight 5 -Port 8080 -Target sipservice.contoso.com
$RecordSet = New-AzPrivateDnsRecordSet -Name "_sip._tcp" -RecordType SRV -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/myzone.com/SRV/_sip._tcp
Name : _sip._tcp
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : SRV
Records : {[0,5,8080,sipservice.contoso.com]}
Metadata :
IsAutoRegistered :
Ez a parancs létrehoz egy _sip._tcp nevű RecordSetet a privát zónában myzone.com. A rekordhalmaz SRV típusú, és TTL értéke 1 óra (3600 másodperc). Egyetlen saját 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 csak egy sornyi pn_PowerShell_short szeretne rekordhalmazt létrehozni, vagy több rekordot tartalmazó rekordhalmazt szeretne létrehozni, tekintse meg az 1. példát.
7. példa: TXT típusú RecordSet létrehozása
$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Value "This is a TXT Record"
$RecordSet = New-AzPrivateDnsRecordSet -Name "text" -RecordType TXT -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/myzone.com/TXT/text
Name : text
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : TXT
Records : {This is a TXT Record}
Metadata :
IsAutoRegistered :
Ez a parancs létrehoz egy RecordSet nevű szöveget a privát zónában myzone.com. A rekordhalmaz TXT típusú, és TTL értéke 1 óra (3600 másodperc). Egyetlen saját DNS rekordot tartalmaz. Ha csak egy sornyi pn_PowerShell_short szeretne rekordhalmazt létrehozni, vagy több rekordot tartalmazó rekordhalmazt szeretne létrehozni, tekintse meg az 1. példát.
8. példa: RecordSet létrehozása a zóna csúcsán
$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Ipv4Address 1.2.3.4
$RecordSet = New-AzPrivateDnsRecordSet -Name "@" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/myzone.com/A/@
Name : @
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : A
Records : {1.2.3.4}
Metadata :
IsAutoRegistered :
Ez a parancs létrehoz egy RecordSetet a privát zóna csúcsánál (vagy gyökerénél), 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 saját DNS korlátozása. Ha csak egy sornyi pn_PowerShell_short szeretne rekordhalmazt létrehozni, vagy több rekordot tartalmazó rekordhalmazt szeretne létrehozni, tekintse meg az 1. példát.
9. példa: Helyettesítő karakterek rekordkészletének létrehozása
$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Ipv4Address 1.2.3.4
$RecordSet = New-AzPrivateDnsRecordSet -Name "*" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/myzone.com/A/@
Name : *
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : A
Records : {1.2.3.4}
Metadata :
IsAutoRegistered :
Ez a parancs létrehoz egy * nevű RecordSetet a privát zónában myzone.com. Ez egy helyettesítő karakterkészlet. Ha csak egy sornyi pn_PowerShell_short szeretne rekordhalmazt létrehozni, vagy több rekordot tartalmazó rekordhalmazt szeretne létrehozni, tekintse meg az 1. példát.
10. példa: Üres rekordkészlet létrehozása
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords @()
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/myzone.com/A/@
Name : *
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : A
Records : {}
Metadata :
IsAutoRegistered :
Ez a parancs létrehoz egy * nevű RecordSetet a privát zónában 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á.
11. példa: Hozzon létre egy rekordhalmazt, és tiltsa le az összes megerősítést
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords (New-AzDnsRecordConfig -Ipv4Address 1.2.3.4) -Confirm:$False -Overwrite
Ez a parancs létrehoz egy RecordSetet. Az 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ési $False értékkel rendelkező paraméter letiltja a megerősítési kérést.
Paraméterek
-Confirm
Jóváhagyást kér a parancsmag futtatása előtt.
Típus: | SwitchParameter |
Aliasok: | cf |
Position: | Named |
Alapértelmezett érték: | None |
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 |
-Metadata
Erőforráscímkéket ábrázoló kivonattábla.
Típus: | Hashtable |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Name
Az ebben a rekordhalmazban lévő rekordok neve (a zóna nevéhez viszonyítva, megszüntető pont nélkül).
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Overwrite
Ne hiúsuljön meg, ha a rekordhalmaz 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 |
-ParentResourceId
saját DNS zóna erőforrás-azonosítóját.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-PrivateDnsRecord
A rekordhalmaz részét képező privát DNS-rekordok.
Típus: | PSPrivateDnsRecordBase[] |
Aliasok: | PrivateDnsRecords |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-RecordType
A rekordhalmazban lévő saját DNS rekordok típusa.
Típus: | RecordType |
Elfogadott értékek: | A, AAAA, CNAME, MX, PTR, SOA, SRV, TXT |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-ResourceGroupName
Az az erőforráscsoport, amelyhez a zóna tartozik.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Ttl
A rekordhalmaz összes rekordjának TTL-értéke.
Típus: | UInt32 |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-WhatIf
Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.
Típus: | SwitchParameter |
Aliasok: | wi |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Zone
A PrivateDnsZone objektum, amely azt a zónát jelöli, amelyben létre kívánja hozni a rekordhalmazt.
Típus: | PSPrivateDnsZone |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-ZoneName
Az a zóna, amelyben létre kívánja hozni a rekordhalmazt (megszüntető pont nélkül).
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |