Delen via


New-AzDnsRecordSet

Hiermee maakt u een DNS-recordset.

Syntaxis

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

Description

De cmdlet New-AzDnsRecordSet maakt een nieuwe DNS-recordset (Domain Name System) met de opgegeven naam en typ de opgegeven zone. Een RecordSet-object is een set DNS-records met dezelfde naam en hetzelfde type. Houd er rekening mee dat de naam relatief is ten opzichte van de zone en niet de volledig gekwalificeerde naam. De parameter DnsRecords specificeert de records in de recordset. Deze parameter gebruikt een matrix van DNS-records, samengesteld met behulp van New-AzDnsRecordConfig. U kunt de pijplijnoperator gebruiken om een DnsZone-object door te geven aan deze cmdlet, of u kunt een DnsZone-object doorgeven als de zoneparameter , of u kunt de zone op naam opgeven. U kunt de parameter Bevestigen en $ConfirmPreference Windows PowerShell-variabele gebruiken om te bepalen of de cmdlet u om bevestiging vraagt. Als er al een overeenkomende RecordSet bestaat (dezelfde naam en hetzelfde recordtype), moet u de parameter Overschrijven opgeven, anders maakt de cmdlet geen nieuwe RecordSet .

Voorbeelden

Voorbeeld 1: Een recordset van het type A maken

$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 dit voorbeeld wordt een RecordSet gemaakt met de naam www in de zone myzone.com. De recordset is van het type A en heeft een TTL van 1 uur (3600 seconden). Het bevat één DNS-record.

Voorbeeld 2: Een recordset van het type AAAA maken

$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 dit voorbeeld wordt een RecordSet gemaakt met de naam www in de zone myzone.com. De recordset is van het type AAAA en heeft een TTL van 1 uur (3600 seconden). Het bevat één DNS-record. Zie voorbeeld 1 als u een recordset wilt maken met slechts één regel pn_PowerShell_short of als u een recordset met meerdere records wilt maken.

Voorbeeld 3: Een RecordSet van het type CNAME maken

$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 dit voorbeeld wordt een RecordSet gemaakt met de naam www in de zone myzone.com. De recordset is van het type CNAME en heeft een TTL van 1 uur (3600 seconden). Het bevat één DNS-record. Zie voorbeeld 1 als u een recordset wilt maken met slechts één regel pn_PowerShell_short of als u een recordset met meerdere records wilt maken.

Voorbeeld 4: Een RecordSet van het type MX maken

$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

Met deze opdracht maakt u een RecordSet met de naam www in de zone myzone.com. De recordset is van het type MX en heeft een TTL van 1 uur (3600 seconden). Het bevat één DNS-record. Zie voorbeeld 1 als u een recordset wilt maken met slechts één regel pn_PowerShell_short of als u een recordset met meerdere records wilt maken.

Voorbeeld 5: Een recordset van het type NS maken

$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

Met deze opdracht maakt u een RecordSet met de naam ns1 in de zone myzone.com. De recordset is van het type NS en heeft een TTL van 1 uur (3600 seconden). Het bevat één DNS-record. Zie voorbeeld 1 als u een recordset wilt maken met slechts één regel pn_PowerShell_short of als u een recordset met meerdere records wilt maken.

Voorbeeld 6: Een recordset van het type PTR maken

$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

Met deze opdracht maakt u een RecordSet met de naam 4 in de zone 3.2.1.in-addr.arpa. De recordset is van het type PTR en heeft een TTL van 1 uur (3600 seconden). Het bevat één DNS-record. Zie voorbeeld 1 als u een recordset wilt maken met slechts één regel pn_PowerShell_short of als u een recordset met meerdere records wilt maken.

Voorbeeld 7: Een RecordSet van het type SRV maken

$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

Met deze opdracht maakt u een RecordSet met de naam _sip._tcp in de zone myzone.com. De recordset is van het type SRV en heeft een TTL van 1 uur (3600 seconden). Het bevat één DNS-record, die verwijst naar het IP-adres 2001.2.3.4. De service (sip) en het protocol (tcp) worden opgegeven als onderdeel van de naam van de recordset, niet als onderdeel van de recordgegevens. Zie voorbeeld 1 als u een recordset wilt maken met slechts één regel pn_PowerShell_short of als u een recordset met meerdere records wilt maken.

Voorbeeld 8: Een RecordSet van het type TXT maken

$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

Met deze opdracht maakt u een recordset met de naam tekst in de zone myzone.com. De recordset is van het type TXT en heeft een TTL van 1 uur (3600 seconden). Het bevat één DNS-record. Zie voorbeeld 1 als u een recordset wilt maken met slechts één regel pn_PowerShell_short of als u een recordset met meerdere records wilt maken.

Voorbeeld 9: Een RecordSet maken in de 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

Met deze opdracht maakt u een RecordSet in het apex (of de hoofdmap) van de zone myzone.com. Hiervoor wordt de naam van de recordset opgegeven als @(inclusief de dubbele aanhalingstekens). U kunt geen CNAME-records maken in de apex van een zone. Dit is een beperking van de DNS-standaarden; het is geen beperking van Azure DNS. Zie voorbeeld 1 als u een recordset wilt maken met slechts één regel pn_PowerShell_short of als u een recordset met meerdere records wilt maken.

Voorbeeld 10: Een recordset met jokertekens maken

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

Met deze opdracht maakt u een RecordSet met de naam * in de zone myzone.com. Dit is een recordset met jokertekens. Zie voorbeeld 1 als u een recordset wilt maken met slechts één regel pn_PowerShell_short of als u een recordset met meerdere records wilt maken.

Voorbeeld 11: Een lege recordset maken

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

Met deze opdracht maakt u een RecordSet met de naam www in de zone myzone.com. De recordset is van het type A en heeft een TTL van 1 uur (3600 seconden). Dit is een lege recordset, die fungeert als een tijdelijke aanduiding waaraan u later records kunt toevoegen.

Voorbeeld 12: Een recordset maken en alle bevestiging onderdrukken

$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

Met deze opdracht maakt u een RecordSet. De parameter Overschrijven zorgt ervoor dat deze recordset alle bestaande recordset met dezelfde naam en hetzelfde type overschrijft (bestaande records in die recordset gaan verloren). De parameter Bevestigen met een waarde van $False onderdrukt de bevestigingsprompt.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DnsRecords

Hiermee geeft u de matrix van DNS-records die moeten worden opgenomen in de recordset. U kunt de cmdlet New-AzDnsRecordConfig gebruiken om DNS-recordobjecten te maken. Zie de voorbeelden voor meer informatie.

Type:DnsRecordBase[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Metadata

Hiermee geeft u een matrix van metagegevens die aan de RecordSet moeten worden gekoppeld. Metagegevens worden opgegeven met naam-waardeparen die worden weergegeven als hashtabellen, bijvoorbeeld @{"dept"="shopping";" env"="production"}.

Type:Hashtable
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van de RecordSet die moet worden gemaakt.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Overwrite

Geeft aan dat deze cmdlet de opgegeven RecordSet overschrijft als deze al bestaat.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RecordType

Hiermee geeft u het type DNS-record dat moet worden gemaakt. Geldige waarden zijn:

  • A
  • AAAA
  • CNAME
  • MX
  • NS
  • POINTER
  • SRV
  • TXT SOA-records worden automatisch gemaakt wanneer de zone wordt gemaakt en kan niet handmatig worden gemaakt.
Type:RecordType
Geaccepteerde waarden:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourceGroupName

Hiermee geeft u de resourcegroep die de DNS-zone bevat. U moet ook de parameter ZoneName opgeven om de zonenaam op te geven. U kunt ook de zone en resourcegroep opgeven door een DNS-zoneobject door te geven met behulp van de zoneparameter .

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-TargetResourceId

Alias doelresource-id.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Ttl

Hiermee geeft u de Time to Live (TTL) voor de DNS RecordSet.

Type:UInt32
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Zone

Hiermee geeft u de DnsZone waarin de RecordSet moet worden gemaakt. U kunt ook de zone opgeven met behulp van de parameters ZoneName en ResourceGroupName .

Type:DnsZone
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ZoneName

Hiermee geeft u de naam van de zone waarin de RecordSet moet worden gemaakt. U moet ook de resourcegroep opgeven die de zone bevat met behulp van de parameter ResourceGroupName . U kunt ook de zone en resourcegroep opgeven door een DNS-zoneobject door te geven met behulp van de zoneparameter .

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

String

DnsZone

UInt32

RecordType

Hashtable

DnsRecordBase[]

Uitvoerwaarden

DnsRecordSet

Notities

U kunt de parameter Bevestigen gebruiken om te bepalen of deze cmdlet u om bevestiging vraagt. De cmdlet vraagt u standaard om bevestiging als de $ConfirmPreference Windows PowerShell-variabele een waarde gemiddeld of lager heeft. Als u Bevestigen of Bevestigen:$True opgeeft, wordt u door deze cmdlet gevraagd om bevestiging voordat deze wordt uitgevoerd. Als u Confirm:$False opgeeft, wordt u niet om bevestiging gevraagd.