New-AzDnsRecordSet
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
Ausgaben
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.
Ähnliche Themen
Azure PowerShell