New-AzDnsRecordSet

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>
    -RecordType <RecordType>
    -TargetResourceId <String>
    [-Ttl <UInt32>]
    [-Metadata <Hashtable>]
    [-DnsRecords <DnsRecordBase[]>]
    [-Overwrite]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

New-AzDnsRecordSet
    -Name <String>
    -ZoneName <String>
    -ResourceGroupName <String>
    -Ttl <UInt32>
    -RecordType <RecordType>
    -TrafficManagerProfileId <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>
    -RecordType <RecordType>
    -TargetResourceId <String>
    [-Ttl <UInt32>]
    [-Metadata <Hashtable>]
    [-DnsRecords <DnsRecordBase[]>]
    [-Overwrite]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

New-AzDnsRecordSet
    -Name <String>
    -Zone <DnsZone>
    -Ttl <UInt32>
    -RecordType <RecordType>
    -TrafficManagerProfileId <String>
    [-Metadata <Hashtable>]
    [-DnsRecords <DnsRecordBase[]>]
    [-Overwrite]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

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 Windows variable 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 .

$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.

$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.

$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.

$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.

$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.

$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.

$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.

$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.

$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 ; ce n’est pas une limitation de 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.

$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.

$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.

$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.

$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" -Ttl 3600 -TrafficManagerProfileId "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup/providers/Microsoft.Network/trafficManagerProfiles/myprofile"

Cette commande crée un RecordSet nommé www dans la zone myzone.com lié à un profil Azure Traffic Manager (TMLink). Le paramètre TrafficManagerProfileId accepte l’ID de ressource ARM complet d’un profil Traffic Manager. Il s’agit d’un jeu d’enregistrements vide, qui agit comme un espace réservé auquel vous pouvez ajouter ultérieurement des enregistrements.

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

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 PowerShell $ConfirmPreference Windows 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.