Freigeben über

New-AzDnsRecordSet

  • Referenz
Modul:
Az.Dns

Erstellt einen DNS-Eintragssatz.

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

Beschreibung

Das Cmdlet New-AzDnsRecordSet erstellt einen neuen DNS-Eintrag (Domain Name System) mit dem angegebenen Namen und Typ in der angegebenen Zone. Ein RecordSet-Objekt ist eine Reihe von DNS-Einträgen mit demselben Namen und Typ. Beachten Sie, dass der Name relativ zur Zone und nicht zum vollqualifizierten Namen ist. Der Parameter DnsRecords gibt die Datensätze im Datensatzsatz an. Dieser Parameter verwendet ein Array von DNS-Einträgen, das mit New-AzDnsRecordConfig erstellt wurde. Sie können den Pipelineoperator verwenden, um ein DnsZone-Objekt an dieses Cmdlet zu übergeben, oder Sie können ein DnsZone-Objekt als Parameter Zone übergeben 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-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

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

Beispiel 2: Erstellen eines RecordSet vom Typ AAAA

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

In diesem Beispiel wird ein RecordSet namens "www" in der Zone myzone.com erstellt. Der Datensatzsatz ist vom Typ AAAA und hat eine TTL von 1 Stunde (3600 Sekunden). Er enthält einen einzelnen 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-AzDnsRecordConfig -Cname www.contoso.com
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType CNAME -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

In diesem Beispiel wird ein RecordSet namens "www" in der Zone myzone.com erstellt. Der Datensatzsatz ist vom Typ CNAME und hat eine TTL von 1 Stunde (3600 Sekunden). Er enthält einen einzelnen 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-AzDnsRecordConfig -Exchange "mail.microsoft.com" -Preference 5
$RecordSet = New-AzDnsRecordSet -Name "mail" -RecordType MX -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

Mit diesem Befehl wird ein RecordSet namens "www" in der Zone myzone.com erstellt. Der Datensatzsatz ist vom Typ MX und hat eine TTL von 1 Stunde (3600 Sekunden). Er enthält einen einzelnen 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 NS

$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

Mit diesem Befehl wird ein RecordSet mit dem Namen "ns1" in der Zone myzone.com erstellt. Der Datensatzsatz ist vom Typ NS und hat eine TTL von 1 Stunde (3600 Sekunden). Er enthält einen einzelnen 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 PTR

$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

Mit diesem Befehl wird ein RecordSet namens 4 in der 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 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 7: Erstellen eines RecordSet vom Typ SRV

$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

Mit diesem Befehl wird ein RecordSet namens _sip._tcp in der Zone myzone.com erstellt. Der Datensatzsatz ist vom Typ SRV und hat eine TTL von 1 Stunde (3600 Sekunden). Er enthält einen einzelnen 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 8: Erstellen eines RecordSet vom Typ TXT

$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

Mit diesem Befehl wird ein RecordSet namens Text in der Zone myzone.com erstellt. Der Datensatzsatz ist vom Typ TXT und hat eine TTL von 1 Stunde (3600 Sekunden). Er enthält einen einzelnen 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 9: Erstellen eines RecordSets an der Zone apex

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

Mit diesem Befehl wird ein RecordSet an der Spitze (oder stamm) der 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 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 10: Erstellen eines Datensatzsatzes für Einen Wildcard

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

Mit diesem Befehl wird ein RecordSet mit dem Namen * in der 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 11: Erstellen eines leeren Datensatzsatzes

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

Mit diesem Befehl wird ein RecordSet namens "www" in der 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 12: Erstellen eines Datensatzsatzes und Unterdrücken aller Bestätigungen

$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

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

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

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

-DnsRecords

Gibt das Array von DNS-Einträgen an, die in den Datensatzsatz aufgenommen werden sollen. Sie können das Cmdlet New-AzDnsRecordConfig verwenden, um DNS-Eintragsobjekte zu erstellen. Weitere Informationen finden Sie in den Beispielen.

Typ:DnsRecordBase[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Metadata

Gibt ein Array von Metadaten an, die dem RecordSet zugeordnet werden sollen. Metadaten werden mithilfe von Name-Wert-Paaren angegeben, die als Hashtabellen dargestellt werden, z. B. @{"dept"="shopping";" env"="production"}.

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

-Name

Gibt den Namen des zu erstellenden RecordSets an.

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

-Overwrite

Gibt an, dass dieses Cmdlet das angegebene RecordSet überschreibt, wenn es bereits vorhanden ist.

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

-RecordType

Gibt den Typ des zu erstellenden DNS-Eintrags an. Gültige Werte sind:

  • A
  • AAAA
  • CNAME
  • MX
  • NS
  • PTR
  • SRV
  • TXT SOA-Einträge werden automatisch erstellt, wenn die Zone erstellt wird und nicht manuell erstellt werden kann.
Typ:RecordType
Zulässige Werte:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Gibt die Ressourcengruppe an, die die DNS-Zone enthält. Sie müssen auch den Parameter ZoneName angeben, um den Zonennamen anzugeben. Alternativ können Sie die Zone und Ressourcengruppe angeben, indem Sie ein DNS Zone-Objekt mithilfe des Parameters Zone übergeben.

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

-TargetResourceId

Alias-Zielressourcen-ID.

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

-Ttl

Gibt die Zeit für Live (TTL) für das DNS RecordSet an.

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

-WhatIf

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

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

-Zone

Gibt die DnsZone an, in der das RecordSet erstellt werden soll. Alternativ können Sie die Zone mit den Parametern ZoneName und ResourceGroupName angeben.

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

-ZoneName

Gibt den Namen der Zone an, in der das RecordSet erstellt werden soll. Sie müssen auch die Ressourcengruppe angeben, die die Zone enthält, indem Sie den Parameter ResourceGroupName verwenden . Alternativ können Sie die Zone und Ressourcengruppe angeben, indem Sie ein DNS Zone-Objekt mithilfe des Parameters Zone übergeben.

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

Eingaben

String

DnsZone

UInt32

RecordType

Hashtable

DnsRecordBase[]

Ausgaben

DnsRecordSet

Hinweise

Mit dem Parameter "Confirm" können Sie steuern, ob dieses Cmdlet Sie zur Bestätigung auffordert. Standardmäßig werden Sie vom Cmdlet zur Bestätigung aufgefordert, wenn die $ConfirmPreference Windows PowerShell-Variable den Wert "Mittel" oder "niedriger" aufweist. Wenn Sie "Confirm" oder "Confirm:$True" angeben, werden Sie mit diesem Cmdlet vor der Ausführung zur Bestätigung aufgefordert. Wenn Sie "Confirm:$False" angeben, werden Sie vom Cmdlet nicht zur Bestätigung aufgefordert.