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

Beschreibung

Das Cmdlet New-AzDnsRecordConfig erstellt ein lokales DnsRecord-Objekt . Ein Array dieser Objekte wird mithilfe des DnsRecords-Parameters an das New-AzDnsRecordSet-Cmdlet ü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 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 "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 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 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 namens 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 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 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 mit dem Namen _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 RecordSets mit nur einer Zeile pn_PowerShell_short oder zum Erstellen eines Datensatzsatzes mit mehreren Datensätzen finden Sie in 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

-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

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

-Selector

Das Selektorfeld des hinzuzufügenden TLSA-Eintrags.

Typ:Int32
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

String

UInt16

Byte

Ausgaben

DnsRecordBase