New-AzPrivateDnsRecordSet

Référence

Module:: Az.PrivateDns

Crée un jeu d’enregistrements dans une zone DNS privé.

Syntaxe

New-AzPrivateDnsRecordSet
   -ResourceGroupName <String>
   -ZoneName <String>
   -Name <String>
   -RecordType <RecordType>
   -Ttl <UInt32>
   [-Metadata <Hashtable>]
   [-PrivateDnsRecord <PSPrivateDnsRecordBase[]>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzPrivateDnsRecordSet
   -Zone <PSPrivateDnsZone>
   -Name <String>
   -RecordType <RecordType>
   -Ttl <UInt32>
   [-Metadata <Hashtable>]
   [-PrivateDnsRecord <PSPrivateDnsRecordBase[]>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzPrivateDnsRecordSet
   -ParentResourceId <String>
   -Name <String>
   -RecordType <RecordType>
   -Ttl <UInt32>
   [-Metadata <Hashtable>]
   [-PrivateDnsRecord <PSPrivateDnsRecordBase[]>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande New-AzPrivateDnsRecordSet crée un jeu d’enregistrements DNS (Private Domain Name System) avec le nom et le type spécifiés dans la zone privée spécifiée. Un objet RecordSet est un ensemble d’enregistrements DNS privé portant le même nom et le même type. Notez que le nom est relatif à la zone privée et non au nom complet. Le paramètre PrivateDnsRecord spécifie les enregistrements dans le jeu d’enregistrements. Ce paramètre prend un tableau d’enregistrements DNS privé, construit à l’aide de New-AzPrivateDnsRecordConfig. Vous pouvez utiliser l’opérateur de pipeline pour passer un objet PSPrivateDnsZone à cette applet de commande, ou passer un objet PSPrivateDnsZone en tant que paramètre Zone, ou vous pouvez spécifier la zone par son ResourceId, 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-AzPrivateDnsRecordConfig -IPv4Address 1.2.3.4
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

# When creating a RecordSet containing a single record, the above sequence can also be condensed into a single line:

$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords (New-AzPrivateDnsRecordConfig -IPv4Address 1.2.3.4)

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/providers/Microsoft.Netwo
                    rk/privateDnsZones/myzone.com/A/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {1.2.3.4}
Metadata          :
IsAutoRegistered  :


# To create a record set containing multiple records, use New-AzPrivateDnsRecordConfig to add each record to the $Records array,
# then call New-AzPrivateDnsRecordSet, as follows:

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -IPv4Address 1.2.3.4
$Records += New-AzPrivateDnsRecordConfig -IPv4Address 5.6.7.8
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/providers/Microsoft.Netwo
                    rk/privateDnsZones/myzone.com/A/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {1.2.3.4, 5.6.7.8}
Metadata          :
IsAutoRegistered  :

Cet exemple crée un RecordSet nommé www dans la zone privée 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 privé unique.

Exemple 2 : Créer un RecordSet de type AAAA

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Ipv6Address 2001:db8::1
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType AAAA -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/AAAA/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : AAAA
Records           : {2001:db8::1}
Metadata          :
IsAutoRegistered  :

Cet exemple crée un RecordSet nommé www dans la zone privée 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 privé 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-AzPrivateDnsRecordConfig -Cname www.contoso.com
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType CNAME -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/CNAME/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : CNAME
Records           : {www.contoso.com}
Metadata          :
IsAutoRegistered  :

Cet exemple crée un RecordSet nommé www dans la zone privée 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 privé 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-AzPrivateDnsRecordConfig -Exchange "mail.microsoft.com" -Preference 5
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType MX -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/MX/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : MX
Records           : {[5,mail.microsoft.com]}
Metadata          :
IsAutoRegistered  :

Cette commande crée un RecordSet nommé www dans la zone privée 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 privé 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 PTR

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Ptrdname www.contoso.com
$RecordSet = New-AzPrivateDnsRecordSet -Name "4" -RecordType PTR -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "3.2.1.in-addr.arpa" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/3.2.1.in-addr.arpa/PTR/4
Name              : 4
ZoneName          : 3.2.1.in-addr.arpa
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : PTR
Records           : {www.contoso.com}
Metadata          :
IsAutoRegistered  :

Cette commande crée un Jeu d’enregistrements nommé 4 dans la zone privée 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 privé 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 SRV

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Priority 0 -Weight 5 -Port 8080 -Target sipservice.contoso.com
$RecordSet = New-AzPrivateDnsRecordSet -Name "_sip._tcp" -RecordType SRV -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/SRV/_sip._tcp
Name              : _sip._tcp
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : SRV
Records           : {[0,5,8080,sipservice.contoso.com]}
Metadata          :
IsAutoRegistered  :

Cette commande crée un Jeu d’enregistrements nommé _sip._tcp dans la zone privée 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 privé 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 7 : Créer un RecordSet de type TXT

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Value "This is a TXT Record"
$RecordSet = New-AzPrivateDnsRecordSet -Name "text" -RecordType TXT -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/TXT/text
Name              : text
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : TXT
Records           : {This is a TXT Record}
Metadata          :
IsAutoRegistered  :

Cette commande crée un texte nommé RecordSet dans la zone privée 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 privé 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 8 : Créer un Jeu d’enregistrements à l’apex de la zone

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

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/A/@
Name              : @
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {1.2.3.4}
Metadata          :
IsAutoRegistered  :

Cette commande crée un RecordSet à l’apex (ou à la racine) de la zone privée 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 privé. 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 générique

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

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/A/@
Name              : *
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {1.2.3.4}
Metadata          :
IsAutoRegistered  :

Cette commande crée un RecordSet nommé * dans la zone privée 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 10 : Créer un jeu d’enregistrements vide

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

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/A/@
Name              : *
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {}
Metadata          :
IsAutoRegistered  :

Cette commande crée un RecordSet nommé * dans la zone privée 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 11 : Créer un jeu d’enregistrements et supprimer toute confirmation

$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords (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 l’applet de commande.

Type:	SwitchParameter
Alias:	cf
Position:	Named
Valeur par défaut:	None
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

-Metadata

Table de hachage qui représente les balises de ressource.

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

-Name

Nom des enregistrements de ce jeu d’enregistrements (par rapport au nom de la zone et sans point de fin).

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

-Overwrite

Ne pas échouer si le jeu d’enregistrements 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

-ParentResourceId

DNS privé ResourceID de 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

-PrivateDnsRecord

Enregistrements dns privés qui font partie de ce jeu d’enregistrements.

Type:	PSPrivateDnsRecordBase[]
Alias:	PrivateDnsRecords
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

Type d’enregistrements DNS privé dans ce jeu d’enregistrements.

Type:	RecordType
Valeurs acceptées:	A, AAAA, CNAME, MX, PTR, SOA, SRV, TXT
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ResourceGroupName

Groupe de ressources auquel appartient la zone.

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

Valeur de durée de vie de tous les enregistrements de ce jeu d’enregistrements.

Type:	UInt32
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
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:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Zone

Objet PrivateDnsZone représentant la zone dans laquelle créer le jeu d’enregistrements.

Type:	PSPrivateDnsZone
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

Zone dans laquelle créer le jeu d’enregistrements (sans point de fin).

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

Entrées

PSPrivateDnsZone

String

Sorties

PSPrivateDnsRecordSet

Partager via