New-AzDnsRecordConfig

Crée un objet local d’enregistrement DNS.

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

Description

L’applet de commande New-AzDnsRecordConfig crée un objet DnsRecord local. Un tableau de ces objets est passé à l’applet de commande New-AzDnsRecordSet à l’aide du paramètre DnsRecords pour spécifier les enregistrements à créer dans le jeu d’enregistrements.

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 "www" -RecordType AAAA -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 de type 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

Cette commande crée un Jeu d’enregistrements nommé childds dans la zone myzone.com. Le jeu d’enregistrements est de type DS et a une durée de vie de 1 heure (3600 secondes). Il contient un enregistrement DNS unique. Les données d’enregistrement contiennent l’étiquette clé, l’algorithme, le type de synthèse et le digest de l’enregistrement DNSKEY de la zone enfant. 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 RecordSet de type 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

Cette commande crée un Jeu d’enregistrements nommé _443._tcp.www dans la zone myzone.com. Le jeu d’enregistrements est de type TLSA et a une durée de vie de 1 heure (3600 secondes). Il contient un enregistrement DNS unique. Les données d’enregistrement contiennent l’utilisation, le sélecteur et le type correspondant des données d’association de certificats. 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.

Paramètres

-Algorithm

Champ d’algorithme de l’enregistrement DS à ajouter.

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-CaaFlags

Indicateurs pour l’enregistrement CAA à ajouter. Doit être un nombre compris entre 0 et 255.

Type:Byte
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-CaaTag

Champ d’étiquette de l’enregistrement CAA à ajouter.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-CaaValue

Champ valeur de l’enregistrement CAA à ajouter.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-CertificateAssociationData

Champ de données d’association de certificats de l’enregistrement TLSA à ajouter.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Cname

Spécifie le nom de domaine d’un enregistrement de nom canonique (CNAME).

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Digest

Champ de synthèse de l’enregistrement DS à ajouter.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DigestType

Champ de type digest de l’enregistrement DS à ajouter.

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Exchange

Spécifie le nom du serveur d’échange de courrier pour un enregistrement MX (Mail Exchange).

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Ipv4Address

Spécifie une adresse IPv4 pour un enregistrement A.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Ipv6Address

Spécifie une adresse IPv6 pour un enregistrement AAAA.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-KeyTag

Champ d’étiquette de clé de l’enregistrement DS à ajouter.

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MatchingType

Champ de type correspondant de l’enregistrement TLSA à ajouter.

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Nsdname

Spécifie le nom du serveur de noms pour un enregistrement de serveur de noms (NS).

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Port

Spécifie le port d’un enregistrement de service (SRV).

Type:UInt16
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Preference

Spécifie la préférence pour un enregistrement MX.

Type:UInt16
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Priority

Spécifie la priorité d’un enregistrement SRV.

Type:UInt16
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Ptrdname

Spécifie le nom de domaine cible d’un enregistrement de ressource de pointeur (PTR).

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Selector

Champ sélecteur de l’enregistrement TLSA à ajouter.

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Target

Spécifie la cible d’un enregistrement SRV.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Usage

Champ d’utilisation de l’enregistrement TLSA à ajouter.

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Value

Spécifie la valeur d’un enregistrement TXT.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Weight

Spécifie le poids d’un enregistrement SRV.

Type:UInt16
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Entrées

String

UInt16

Byte

Sorties

DnsRecordBase