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 Do Standard Name System (DNS)-Eintrag 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 Wild Karte Datensatzsatzes
$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 Wild Karte Datensatzsatz. 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.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | DnsRecordBase[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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"}.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Gibt den Namen des zu erstellenden RecordSets an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Overwrite
Gibt an, dass dieses Cmdlet das angegebene RecordSet überschreibt, wenn es bereits vorhanden ist.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | RecordType |
Accepted values: | A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TargetResourceId
Alias-Zielressourcen-ID.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Ttl
Gibt die Zeit für Live (TTL) für das DNS RecordSet an.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | DnsZone |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für