Freigeben über

New-AzPrivateDnsRecordSet

  • Referenz
Modul:
Az.PrivateDns

Erstellt einen Datensatzsatz in einer privaten DNS-Zone.

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

Beschreibung

Das Cmdlet New-AzPrivateDnsRecordSet erstellt einen neuen DNS-Eintrag (Private Domain Name System) mit dem angegebenen Namen und Typ in der angegebenen privaten Zone. Ein RecordSet-Objekt ist eine Gruppe privater DNS-Einträge mit demselben Namen und Typ. Beachten Sie, dass der Name relativ zur privaten Zone und nicht zum vollqualifizierten Namen ist. Der Parameter PrivateDnsRecord gibt die Datensätze im Datensatzsatz an. Dieser Parameter verwendet ein Array von privaten DNS-Einträgen, das mit New-AzPrivateDnsRecordConfig erstellt wurde. Sie können den Pipelineoperator verwenden, um ein PSPrivateDnsZone-Objekt an dieses Cmdlet zu übergeben, oder Sie können ein PSPrivateDnsZone-Objekt als Parameter zone übergeben, oder Sie können die Zone über die ResourceId angeben oder alternativ die Zone anhand des Namens angeben. Sie können den Parameter "Confirm" und $ConfirmPreference Windows PowerShell-Variable verwenden, um zu steuern, ob das Cmdlet Sie zur Bestätigung auffordert. Wenn bereits ein übereinstimmender RecordSet vorhanden ist (identischer Name und Datensatztyp), müssen Sie den Overwrite-Parameter angeben, andernfalls erstellt das Cmdlet kein neues RecordSet.

Beispiele

Beispiel 1: Erstellen eines RecordSets vom Typ A

$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  :

In diesem Beispiel wird ein RecordSet mit dem Namen "www" in der privaten Zone myzone.com erstellt. Der Datensatzsatz ist vom Typ A und hat eine TTL von 1 Stunde (3600 Sekunden). Er enthält einen einzelnen privaten DNS-Eintrag.

Beispiel 2: Erstellen eines RecordSet vom Typ AAAA

$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  :

In diesem Beispiel wird ein RecordSet mit dem Namen "www" in der privaten Zone myzone.com erstellt. Der Datensatzsatz ist vom Typ AAAA und hat eine TTL von 1 Stunde (3600 Sekunden). Er enthält einen einzelnen privaten DNS-Eintrag. Informationen zum Erstellen eines RecordSets mit nur einer Zeile pn_PowerShell_short oder zum Erstellen eines Datensatzsatzes mit mehreren Datensätzen finden Sie in Beispiel 1.

Beispiel 3: Erstellen eines RecordSet vom Typ CNAME

$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  :

In diesem Beispiel wird ein RecordSet mit dem Namen "www" in der privaten Zone myzone.com erstellt. Der Datensatzsatz ist vom Typ CNAME und hat eine TTL von 1 Stunde (3600 Sekunden). Er enthält einen einzelnen privaten DNS-Eintrag. Informationen zum Erstellen eines RecordSets mit nur einer Zeile pn_PowerShell_short oder zum Erstellen eines Datensatzsatzes mit mehreren Datensätzen finden Sie in Beispiel 1.

Beispiel 4: Erstellen eines RecordSet-Typs MX

$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  :

Mit diesem Befehl wird ein RecordSet namens "www" in der privaten Zone myzone.com erstellt. Der Datensatzsatz ist vom Typ MX und hat eine TTL von 1 Stunde (3600 Sekunden). Er enthält einen einzelnen privaten DNS-Eintrag. Informationen zum Erstellen eines RecordSets mit nur einer Zeile pn_PowerShell_short oder zum Erstellen eines Datensatzsatzes mit mehreren Datensätzen finden Sie in Beispiel 1.

Beispiel 5: Erstellen eines RecordSet vom Typ PTR

$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  :

Mit diesem Befehl wird ein RecordSet namens 4 in der privaten Zone 3.2.1.in-addr.arpa erstellt. Der Datensatzsatz ist vom Typ PTR und hat eine TTL von 1 Stunde (3600 Sekunden). Er enthält einen einzelnen privaten DNS-Eintrag. Informationen zum Erstellen eines RecordSets mit nur einer Zeile pn_PowerShell_short oder zum Erstellen eines Datensatzsatzes mit mehreren Datensätzen finden Sie in Beispiel 1.

Beispiel 6: Erstellen eines RecordSet vom Typ SRV

$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  :

Mit diesem Befehl wird ein RecordSet namens _sip._tcp in der privaten Zone myzone.com erstellt. Der Datensatzsatz ist vom Typ SRV und hat eine TTL von 1 Stunde (3600 Sekunden). Er enthält einen einzelnen privaten DNS-Eintrag, der auf die IP-Adresse 2001.2.3.4 verweist. Der Dienst (sip) und das Protokoll (TCP) werden als Teil des Datensatzsatznamens angegeben, nicht als Teil der Datensatzdaten. Informationen zum Erstellen eines RecordSets mit nur einer Zeile pn_PowerShell_short oder zum Erstellen eines Datensatzsatzes mit mehreren Datensätzen finden Sie in Beispiel 1.

Beispiel 7: Erstellen eines RecordSet vom Typ TXT

$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  :

Mit diesem Befehl wird ein RecordSet namens Text in der privaten Zone myzone.com erstellt. Der Datensatzsatz ist vom Typ TXT und hat eine TTL von 1 Stunde (3600 Sekunden). Er enthält einen einzelnen privaten DNS-Eintrag. Informationen zum Erstellen eines RecordSets mit nur einer Zeile pn_PowerShell_short oder zum Erstellen eines Datensatzsatzes mit mehreren Datensätzen finden Sie in Beispiel 1.

Beispiel 8: Erstellen eines RecordSets an der Zone apex

$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  :

Mit diesem Befehl wird ein RecordSet an der Spitze (oder stamm) der privaten Zone myzone.com erstellt. Dazu wird der Datensatzsatzname als "@" angegeben (einschließlich der doppelten Anführungszeichen). Sie können keine CNAME-Einträge am Scheitelpunkt einer Zone erstellen. Dies ist eine Einschränkung der DNS-Standards; es ist keine Einschränkung von Azure Private DNS. Informationen zum Erstellen eines RecordSets mit nur einer Zeile pn_PowerShell_short oder zum Erstellen eines Datensatzsatzes mit mehreren Datensätzen finden Sie in Beispiel 1.

Beispiel 9: Erstellen eines Datensatzsatzes für Einen Wildcard

$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  :

Mit diesem Befehl wird ein RecordSet mit dem Namen * in der privaten Zone myzone.com erstellt. Dies ist ein Datensatzsatz mit Einem Wildcard.This is a wildcard record set. Informationen zum Erstellen eines RecordSets mit nur einer Zeile pn_PowerShell_short oder zum Erstellen eines Datensatzsatzes mit mehreren Datensätzen finden Sie in Beispiel 1.

Beispiel 10: Erstellen eines leeren Datensatzsatzes

$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  :

Mit diesem Befehl wird ein RecordSet mit dem Namen * in der privaten Zone myzone.com erstellt. Der Datensatzsatz ist vom Typ A und hat eine TTL von 1 Stunde (3600 Sekunden). Dies ist ein leerer Datensatzsatz, der als Platzhalter fungiert, dem Sie später Datensätze hinzufügen können.

Beispiel 11: Erstellen eines Datensatzsatzes und Unterdrücken aller Bestätigungen

$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

Mit diesem Befehl wird ein RecordSet erstellt. Der Parameter Overwrite stellt sicher, dass dieser Datensatzsatz alle bereits vorhandenen Datensätze mit demselben Namen und Typ überschreibt (vorhandene Datensätze in diesem Datensatzsatz gehen verloren). Der Parameter "Confirm" mit dem Wert $False unterdrückt die Bestätigungsaufforderung.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Metadata

Eine Hashtabelle, die Ressourcentags darstellt.

Typ:Hashtable
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Der Name der Datensätze in diesem Datensatzsatz (relativ zum Namen der Zone und ohne endenden Punkt).

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Overwrite

Führen Sie keinen Fehler aus, wenn der Datensatzsatz bereits vorhanden ist.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ParentResourceId

Private DNS Zone ResourceID.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PrivateDnsRecord

Die privaten DNS-Einträge, die Teil dieses Datensatzsatzes sind.

Typ:PSPrivateDnsRecordBase[]
Aliase:PrivateDnsRecords
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RecordType

Der Typ der privaten DNS-Einträge in diesem Datensatzsatz.

Typ:RecordType
Zulässige Werte:A, AAAA, CNAME, MX, PTR, SOA, SRV, TXT
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Die Ressourcengruppe, zu der die Zone gehört.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Ttl

Der TTL-Wert aller Datensätze in diesem Datensatzsatz.

Typ:UInt32
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Zone

Das PrivateDnsZone -Objekt, das die Zone darstellt, in der der Datensatzsatz erstellt werden soll.

Typ:PSPrivateDnsZone
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ZoneName

Die Zone, in der der Datensatzsatz erstellt werden soll (ohne einen punktierenden Punkt).

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

PSPrivateDnsZone

String

Ausgaben

PSPrivateDnsRecordSet