Set-AzDnsRecordSet

  • Référence
Module:
Az.Dns

Mises à jour un jeu d’enregistrements DNS.

Syntax

Set-AzDnsRecordSet
   -RecordSet <DnsRecordSet>
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande Set-AzDnsRecordSet met à jour un jeu d’enregistrements dans le service Azure DNS à partir d’un objet RecordSet local. Vous pouvez passer un objet RecordSet en tant que paramètre ou à l’aide de l’opérateur de pipeline. Vous pouvez utiliser le paramètre Confirm et $ConfirmPreference variable Windows PowerShell pour contrôler si l’applet de commande vous invite à confirmer. Le jeu d’enregistrements n’est pas mis à jour s’il a été modifié dans Azure DNS depuis la récupération de l’objet RecordSet local. Cela offre une protection pour les modifications simultanées. Vous pouvez supprimer ce comportement à l’aide du paramètre Overwrite , qui met à jour le jeu d’enregistrements indépendamment des modifications simultanées.

Exemples

Exemple 1 : Mettre à jour un jeu d’enregistrements

$RecordSet = Get-AzDnsRecordSet -ResourceGroupName MyResourceGroup -ZoneName myzone.com -Name www -RecordType A
Add-AzDnsRecordConfig -RecordSet $RecordSet -Ipv4Address 172.16.0.0
Add-AzDnsRecordConfig -RecordSet $RecordSet -Ipv4Address 172.31.255.255
Set-AzDnsRecordSet -RecordSet $RecordSet

# These cmdlets can also be piped:

Get-AzDnsRecordSet -ResourceGroupName MyResourceGroup -ZoneName myzone.com -Name www -RecordType A | Add-AzDnsRecordConfig -Ipv4Address 172.16.0.0 | Add-AzDnsRecordConfig -Ipv4Address 172.31.255.255 | Set-AzDnsRecordSet

La première commande utilise l’applet de commande Get-AzDnsRecordSet pour obtenir le jeu d’enregistrements spécifié, puis la stocke dans la variable $RecordSet. Les deuxième et troisième commandes sont des opérations hors ligne pour ajouter deux enregistrements A au jeu d’enregistrements. La commande finale utilise l’applet de commande Set-AzDnsRecordSet pour valider la mise à jour.

Exemple 2 : Mettre à jour un enregistrement SOA

$Zone = Get-AzDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup"
$RecordSet = Get-AzDnsRecordSet -Name "@" -RecordType SOA -Zone $Zone
$RecordSet.Records[0].Email = "admin.myzone.com"
Set-AzDnsRecordSet -RecordSet $RecordSet

La première commande utilise l’applet de commande Get-AzDnsRecordset pour obtenir le jeu d’enregistrements spécifié, puis la stocke dans la variable $RecordSet. La deuxième commande met à jour l’enregistrement SOA spécifié dans $RecordSet. La commande finale utilise l’applet de commande Set-AzDnsRecordSet pour propager la mise à jour dans $RecordSet.

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
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

-Overwrite

Indique de mettre à jour le jeu d’enregistrements indépendamment des modifications simultanées. Le jeu d’enregistrements ne sera pas mis à jour s’il a été modifié dans Azure DNS depuis la récupération de l’objet RecordSet local. Cela offre une protection pour les modifications simultanées. Pour supprimer ce comportement, vous pouvez utiliser le paramètre Overwrite , ce qui entraîne la mise à jour du jeu d’enregistrements indépendamment des modifications simultanées.

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

-RecordSet

Spécifie le Jeu d’enregistrements à mettre à jour.

Type:DnsRecordSet
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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. Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

DnsRecordSet

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.