New-AzDnsRecordSet

Syntaxe

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

L’applet de commande New-AzDnsRecordSet crée un jeu d’enregistrements DNS (Domain Name System) avec le nom et le type spécifiés dans la zone spécifiée. Un objet RecordSet est un ensemble d’enregistrements DNS portant le même nom et le même type. Notez que le nom est relatif à la zone et non au nom complet. Le paramètre DnsRecords spécifie les enregistrements dans le jeu d’enregistrements. Ce paramètre prend un tableau d’enregistrements DNS, construit à l’aide de New-AzDnsRecordConfig. Vous pouvez utiliser l’opérateur de pipeline pour passer un objet DnsZone à cette applet de commande, ou passer un objet DnsZone en tant que paramètre Zone , ou vous pouvez également spécifier la zone par nom. Vous pouvez utiliser le paramètre Confirm et $ConfirmPreference variable Windows PowerShell pour contrôler si l’applet de commande vous invite à confirmer. Si un RecordSet correspondant existe déjà (même nom et type d’enregistrement), vous devez spécifier le paramètre Overwrite. Sinon, l’applet de commande ne crée pas de nouveau RecordSet.

Exemples

Exemple 1 : Créer un Jeu d’enregistrements de type 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

Cet exemple crée un RecordSet nommé www dans la zone myzone.com. Le jeu d’enregistrements est de type A et a une durée de vie de 1 heure (3600 secondes). Il contient un enregistrement DNS unique.

Exemple 2 : Créer un RecordSet de type 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

Cet exemple crée un RecordSet nommé www dans la zone myzone.com. Le jeu d’enregistrements est de type AAAA et a une durée de vie de 1 heure (3600 secondes). Il contient un enregistrement DNS unique. Pour créer un Jeu d’enregistrements à l’aide d’une seule ligne de pn_PowerShell_short, ou pour créer un jeu d’enregistrements avec plusieurs enregistrements, consultez l’exemple 1.

Exemple 3 : Créer un RecordSet de type 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

Cet exemple crée un RecordSet nommé www dans la zone myzone.com. Le jeu d’enregistrements est de type CNAME et a une durée de vie de 1 heure (3600 secondes). Il contient un enregistrement DNS unique. Pour créer un Jeu d’enregistrements à l’aide d’une seule ligne de pn_PowerShell_short, ou pour créer un jeu d’enregistrements avec plusieurs enregistrements, consultez l’exemple 1.

Exemple 4 : Créer un RecordSet de type 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

Cette commande crée un RecordSet nommé www dans la zone myzone.com. Le jeu d’enregistrements est de type MX et a une durée de vie de 1 heure (3600 secondes). Il contient un enregistrement DNS unique. Pour créer un Jeu d’enregistrements à l’aide d’une seule ligne de pn_PowerShell_short, ou pour créer un jeu d’enregistrements avec plusieurs enregistrements, consultez l’exemple 1.

Exemple 5 : Créer un Jeu d’enregistrements de type 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

Cette commande crée un RecordSet nommé ns1 dans la zone myzone.com. Le jeu d’enregistrements est de type NS et a une durée de vie de 1 heure (3600 secondes). Il contient un enregistrement DNS unique. Pour créer un Jeu d’enregistrements à l’aide d’une seule ligne de pn_PowerShell_short, ou pour créer un jeu d’enregistrements avec plusieurs enregistrements, consultez l’exemple 1.

Exemple 6 : Créer un Jeu d’enregistrements de type 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

Cette commande crée un Jeu d’enregistrements nommé 4 dans la zone 3.2.1.in-addr.arpa. Le jeu d’enregistrements est de type PTR et a une durée de vie de 1 heure (3600 secondes). Il contient un enregistrement DNS unique. Pour créer un Jeu d’enregistrements à l’aide d’une seule ligne de pn_PowerShell_short, ou pour créer un jeu d’enregistrements avec plusieurs enregistrements, consultez l’exemple 1.

Exemple 7 : Créer un Jeu d’enregistrements de type 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

Cette commande crée un Jeu d’enregistrements nommé _sip._tcp dans la zone myzone.com. Le jeu d’enregistrements est de type SRV et a une durée de vie de 1 heure (3600 secondes). Il contient un enregistrement DNS unique, pointant vers l’adresse IP 2001.2.3.4. Le service (sip) et le protocole (tcp) sont spécifiés dans le cadre du nom du jeu d’enregistrements, et non dans le cadre des données d’enregistrement. Pour créer un Jeu d’enregistrements à l’aide d’une seule ligne de pn_PowerShell_short, ou pour créer un jeu d’enregistrements avec plusieurs enregistrements, consultez l’exemple 1.

Exemple 8 : Créer un RecordSet de type 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

Cette commande crée un jeu d’enregistrements nommé texte dans la zone myzone.com. Le jeu d’enregistrements est de type TXT et a une durée de vie de 1 heure (3600 secondes). Il contient un enregistrement DNS unique. Pour créer un Jeu d’enregistrements à l’aide d’une seule ligne de pn_PowerShell_short, ou pour créer un jeu d’enregistrements avec plusieurs enregistrements, consultez l’exemple 1.

Exemple 9 : Créer un Jeu d’enregistrements à l’apex de la zone

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

Cette commande crée un RecordSet à l’apex (ou à la racine) de la zone myzone.com. Pour ce faire, le nom du jeu d’enregistrements est spécifié sous la forme « @ » (y compris les guillemets doubles). Vous ne pouvez pas créer d’enregistrements CNAME au sommet d’une zone. Il s’agit d’une contrainte des normes DNS ; il ne s’agit pas d’une limitation d’Azure DNS. Pour créer un Jeu d’enregistrements à l’aide d’une seule ligne de pn_PowerShell_short, ou pour créer un jeu d’enregistrements avec plusieurs enregistrements, consultez l’exemple 1.

Exemple 10 : Créer un jeu d’enregistrements générique

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

Cette commande crée un Jeu d’enregistrements nommé * dans la zone myzone.com. Il s’agit d’un jeu d’enregistrements génériques. Pour créer un Jeu d’enregistrements à l’aide d’une seule ligne de pn_PowerShell_short, ou pour créer un jeu d’enregistrements avec plusieurs enregistrements, consultez l’exemple 1.

Exemple 11 : Créer un jeu d’enregistrements vide

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

Cette commande crée un RecordSet nommé www dans la zone myzone.com. Le jeu d’enregistrements est de type A et a une durée de vie de 1 heure (3600 secondes). Il s’agit d’un jeu d’enregistrements vide, qui agit comme un espace réservé auquel vous pouvez ajouter ultérieurement des enregistrements.

Exemple 12 : Créer un jeu d’enregistrements et supprimer toute confirmation

$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

Cette commande crée un RecordSet. Le paramètre Overwrite garantit que ce jeu d’enregistrements remplace tout jeu d’enregistrements préexistant avec le même nom et le même type (les enregistrements existants dans ce jeu d’enregistrements sont perdus). Le paramètre Confirm avec la valeur de $False supprime l’invite de confirmation.

Paramètres

-Confirm

-DefaultProfile

-DnsRecords

-Metadata

-Name

-Overwrite

-RecordType

-ResourceGroupName

-TargetResourceId

-Ttl

-WhatIf

-Zone

-ZoneName

Entrées

String

DnsZone

UInt32

RecordType

Hashtable

DnsRecordBase[]

Sorties

DnsRecordSet

Notes

Vous pouvez utiliser le paramètre Confirm pour contrôler si cette applet de commande vous invite à confirmer. Par défaut, l’applet de commande vous invite à confirmer si la variable Windows PowerShell $ConfirmPreference a une valeur moyenne ou inférieure. Si vous spécifiez Confirm ou Confirm :$True, cette applet de commande vous invite à confirmer son exécution. Si vous spécifiez Confirm :$False, l’applet de commande ne vous invite pas à confirmer.

Liens associés

• Add-AzDnsRecordConfig
• Get-AzDnsRecordSet
• New-AzDnsRecordConfig
• Remove-AzDnsRecordSet
• Set-AzDnsRecordSet