Partager via

New-AzDnsRecordSet

  • Référence
Module:
Az.Dns

Crée un jeu d’enregistrements DNS.

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

Vous demande une confirmation avant d’exécuter la commande cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DnsRecords

Spécifie le tableau d’enregistrements DNS à inclure dans le jeu d’enregistrements. Vous pouvez utiliser l’applet de commande New-AzDnsRecordConfig pour créer des objets d’enregistrement DNS. Pour plus d'informations, reportez-vous aux exemples.

Type:DnsRecordBase[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Metadata

Spécifie un tableau de métadonnées à associer au RecordSet. Les métadonnées sont spécifiées à l’aide de paires nom-valeur représentées sous forme de tables de hachage, par exemple @{"dept"="shopping » ; » env"="production"}.

Type:Hashtable
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Spécifie le nom du Jeu d’enregistrements à créer.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Overwrite

Indique que cette applet de commande remplace le RecordSet spécifié s’il existe déjà.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RecordType

Spécifie le type d’enregistrement DNS à créer. Les valeurs valides sont :

  • A
  • AAAA
  • CNAME
  • MX
  • NS
  • PTR
  • SRV
  • Les enregistrements SOA TXT sont créés automatiquement lorsque la zone est créée et ne peuvent pas être créées manuellement.
Type:RecordType
Valeurs acceptées:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ResourceGroupName

Spécifie le groupe de ressources qui contient la zone DNS. Vous devez également spécifier le paramètre ZoneName pour spécifier le nom de la zone. Vous pouvez également spécifier la zone et le groupe de ressources en transmettant un objet zone DNS à l’aide du paramètre Zone .

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-TargetResourceId

ID de ressource cible d’alias.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Ttl

Spécifie la durée de vie (TTL) du Jeu d’enregistrements DNS.

Type:UInt32
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Zone

Spécifie le DnsZone dans lequel créer le Jeu d’enregistrements. Vous pouvez également spécifier la zone à l’aide des paramètres ZoneName et ResourceGroupName .

Type:DnsZone
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ZoneName

Spécifie le nom de la zone dans laquelle créer l’Objet RecordSet. Vous devez également spécifier le groupe de ressources contenant la zone à l’aide du paramètre ResourceGroupName . Vous pouvez également spécifier la zone et le groupe de ressources en transmettant un objet zone DNS à l’aide du paramètre Zone .

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

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.