Freigeben über


New-AzDnsRecordConfig

Erstellt ein neues lokales DNS-Eintragsobjekt.

Syntax

New-AzDnsRecordConfig
   -Ipv4Address <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzDnsRecordConfig
   -Ipv6Address <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzDnsRecordConfig
   -Nsdname <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzDnsRecordConfig
   -Exchange <String>
   -Preference <UInt16>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzDnsRecordConfig
   -Ptrdname <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzDnsRecordConfig
   -Value <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzDnsRecordConfig
   -Priority <UInt16>
   -Target <String>
   -Port <UInt16>
   -Weight <UInt16>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzDnsRecordConfig
   -Cname <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzDnsRecordConfig
   -CaaFlags <Byte>
   -CaaTag <String>
   -CaaValue <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzDnsRecordConfig
   -KeyTag <Int32>
   -Algorithm <Int32>
   -DigestType <Int32>
   -Digest <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzDnsRecordConfig
   -Usage <Int32>
   -Selector <Int32>
   -MatchingType <Int32>
   -CertificateAssociationData <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzDnsRecordConfig
   -Flags <UInt16>
   -Order <UInt16>
   -Preference <UInt16>
   -Services <String>
   -Regexp <String>
   -Replacement <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-AzDnsRecordConfig erstellt ein lokales DnsRecord--Objekt. Ein Array dieser Objekte wird mithilfe des parameters DnsRecords an das cmdlet New-AzDnsRecordSet übergeben, um die datensätze anzugeben, die im Datensatzsatz erstellt werden sollen.

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 RecordSet- mit nur einer Zeile pn_PowerShell_short oder zum Erstellen eines Datensatzsatzes mit mehreren Datensätzen finden Sie unter 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 RecordSet- mit nur einer Zeile pn_PowerShell_short oder zum Erstellen eines Datensatzsatzes mit mehreren Datensätzen finden Sie unter Beispiel 1.

Beispiel 4: Erstellen eines RecordSet-Typs MX

$Records = @()
$Records += New-AzDnsRecordConfig -Exchange "mail.microsoft.com" -Preference 5
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType AAAA -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 RecordSet- mit nur einer Zeile pn_PowerShell_short oder zum Erstellen eines Datensatzsatzes mit mehreren Datensätzen finden Sie unter 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- namens 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 RecordSet- mit nur einer Zeile pn_PowerShell_short oder zum Erstellen eines Datensatzsatzes mit mehreren Datensätzen finden Sie unter 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 RecordSet- mit nur einer Zeile pn_PowerShell_short oder zum Erstellen eines Datensatzsatzes mit mehreren Datensätzen finden Sie unter 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 RecordSet- mit nur einer Zeile pn_PowerShell_short oder zum Erstellen eines Datensatzsatzes mit mehreren Datensätzen finden Sie unter 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- benannter 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 RecordSet- mit nur einer Zeile pn_PowerShell_short oder zum Erstellen eines Datensatzsatzes mit mehreren Datensätzen finden Sie unter Beispiel 1.

Beispiel 9: Erstellen eines RecordSets vom Typ DS

$Records = @()
$Records += New-AzDnsRecordConfig -KeyTag 12345 -Algorithm 3 -DigestType 1 -Digest "49FD46E6C4B45C55D4AC"
$RecordSet = New-AzDnsRecordSet -Name "childds" -RecordType DS -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

Mit diesem Befehl wird ein RecordSet- benannten untergeordneten Elementen in der Zone myzone.com erstellt. Der Datensatzsatz ist vom Typ DS und hat eine TTL von 1 Stunde (3600 Sekunden). Er enthält einen einzelnen DNS-Eintrag. Die Datensatzdaten enthalten das Schlüsseltag, den Algorithmus, den Digesttyp und den Digest des DNSKEY-Eintrags der untergeordneten Zone. Informationen zum Erstellen eines RecordSet- mit nur einer Zeile pn_PowerShell_short oder zum Erstellen eines Datensatzsatzes mit mehreren Datensätzen finden Sie unter Beispiel 1.

Beispiel 10: Erstellen eines RecordSet vom Typ TLSA

$Records = @()
$Records += New-AzDnsRecordConfig -Usage 3 -Selector 1 -MatchingType 1 -CertificateAssociationData "49FD46E6C4B45C55D4AC"
$RecordSet = New-AzDnsRecordSet -Name "_443._tcp.www" -RecordType TLSA -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

Mit diesem Befehl wird ein RecordSet- namens _443._tcp.www in der Zone myzone.com erstellt. Der Datensatzsatz ist vom Typ TLSA und hat eine TTL von 1 Stunde (3600 Sekunden). Er enthält einen einzelnen DNS-Eintrag. Die Datensatzdaten enthalten den Verwendungs-, Selektor- und übereinstimmenden Typ der Zertifikatzuordnungsdaten. Informationen zum Erstellen eines RecordSet- mit nur einer Zeile pn_PowerShell_short oder zum Erstellen eines Datensatzsatzes mit mehreren Datensätzen finden Sie unter Beispiel 1.

Beispiel 11: Erstellen eines RecordSet vom Typ NAPTR

$Records = @()
$Records += New-AzDnsRecordConfig -Flags 0 -Order 100 -Preference 100 -Services "SIP+D2U" -Regexp "" -Replacement "example.com"
$RecordSet = New-AzDnsRecordSet -Name "naptr123" -RecordType NAPTR -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

Mit diesem Befehl wird ein RecordSet- namens naptr123 in der Zone myzone.com erstellt. Der Datensatzsatz ist vom Typ NAPTR und hat eine TTL von 1 Stunde (3600 Sekunden). Er enthält einen einzelnen DNS-Eintrag. Die Datensatzdaten enthalten die Felder "Order", "preference", "flags", "services", "regexp" und "replacement". Informationen zum Erstellen eines RecordSet- mit nur einer Zeile pn_PowerShell_short oder zum Erstellen eines Datensatzsatzes mit mehreren Datensätzen finden Sie unter Beispiel 1.

Parameter

-Algorithm

Das Algorithmusfeld des hinzuzufügenden DS-Eintrags.

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

-CaaFlags

Die Flags für den hinzuzufügenden CAA-Eintrag. Muss eine Zahl zwischen 0 und 255 sein.

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

-CaaTag

Das Tagfeld des hinzuzufügenden CAA-Eintrags.

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

-CaaValue

Das Wertfeld für den hinzuzufügenden CAA-Eintrag.

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

-CertificateAssociationData

Das Feld "Zertifikatzuordnungsdaten" des hinzuzufügenden TLSA-Eintrags.

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

-Cname

Gibt den Domänennamen für einen kanonischen Namen (CNAME)-Eintrag an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
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

-Digest

Das Digestfeld des hinzuzufügenden DS-Eintrags.

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

-DigestType

Das Digesttypfeld des hinzuzufügenden DS-Eintrags.

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

-Exchange

Gibt den Namen des E-Mail-Exchange-Servers für einen MX-Eintrag (Mail Exchange) an.

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

-Flags

Gibt die Flags für einen NAPTR-Eintrag an.

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

-Ipv4Address

Gibt eine IPv4-Adresse für einen A-Eintrag an.

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

-Ipv6Address

Gibt eine IPv6-Adresse für einen AAAA-Eintrag an.

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

-KeyTag

Das Schlüsseltagfeld des hinzuzufügenden DS-Eintrags.

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

-MatchingType

Das übereinstimmende Typfeld des hinzuzufügenden TLSA-Eintrags.

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

-Nsdname

Gibt den Namenservernamen für einen NS-Eintrag (Name Server) an.

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

-Order

Gibt die Reihenfolge für einen NAPTR-Eintrag an.

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

-Port

Gibt den Port für einen Dienstdatensatz (SRV) an.

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

-Preference

Gibt die Einstellung für einen MX/NAPTR-Eintrag an.

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

-Priority

Gibt die Priorität für einen SRV-Eintrag an.

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

-Ptrdname

Gibt den Zieldomänennamen eines PTR-Eintrags (Pointer Resource) an.

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

-Regexp

Gibt die regexp für einen NAPTR-Eintrag an.

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

-Replacement

Gibt den Ersatz für einen NAPTR-Eintrag an.

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

-Selector

Das Selektorfeld des hinzuzufügenden TLSA-Eintrags.

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

-Services

Gibt die Dienste für einen NAPTR-Eintrag an.

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

-Target

Gibt das Ziel für einen SRV-Eintrag an.

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

-Usage

Das Verwendungsfeld des hinzuzufügenden TLSA-Eintrags.

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

-Value

Gibt den Wert für einen TXT-Eintrag an.

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

-Weight

Gibt die Gewichtung für einen SRV-Eintrag an.

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

Eingaben

Ausgaben