Set-AzPrivateDnsRecordSet
Met à jour/définit un jeu d’enregistrements dans une zone DNS privé.
Syntaxe
Set-AzPrivateDnsRecordSet
-RecordSet <PSPrivateDnsRecordSet>
[-Overwrite]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
L’applet de commande Set-AzPrivateDnsRecordSet met à jour un jeu d’enregistrements dans le service Azure DNS privé à 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 privé 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-AzPrivateDnsRecordSet -ResourceGroupName MyResourceGroup -ZoneName myzone.com -Name www -RecordType A
Add-AzPrivateDnsRecordConfig -RecordSet $RecordSet -Ipv4Address 172.16.0.0
Add-AzPrivateDnsRecordConfig -RecordSet $RecordSet -Ipv4Address 172.31.255.255
Set-AzPrivateDnsRecordSet -RecordSet $RecordSet
# These cmdlets can also be piped:
Get-AzPrivateDnsRecordSet -ResourceGroupName MyResourceGroup -ZoneName myzone.com -Name www -RecordType A | Add-AzPrivateDnsRecordConfig -Ipv4Address 172.16.0.0 | Add-AzPrivateDnsRecordConfig -Ipv4Address 172.31.255.255 | Set-AzPrivateDnsRecordSet
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, 172.16.0.0, 172.31.255.255}
Metadata :
IsAutoRegistered :La première commande utilise l’applet de commande Get-AzPrivateDnsRecordSet pour obtenir le jeu d’enregistrements spécifié, puis le 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-AzPrivateDnsRecordSet pour valider la mise à jour.
Exemple 2 : Mettre à jour un enregistrement SOA
$RecordSet = Get-AzPrivateDnsRecordSet -Name "@" -RecordType SOA -Zone $Zone
$RecordSet.Records[0].Email = "admin.myzone.com"
Set-AzPrivateDnsRecordSet -RecordSet $RecordSet
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/myzone.com/SOA/@
Name : @
ZoneName : myzone.com
ResourceGroupName : Myresourcegroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : SOA
Records : {[internal.cloudapp.net,admin.myzone.com,3600,300,2419200,300]}
Metadata :
IsAutoRegistered :La première commande utilise l’applet de commande Get-AzPrivateDnsRecordSet pour obtenir le jeu d’enregistrements spécifié, puis le 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-AzPrivateDnsRecordSet pour propager la mise à jour dans $RecordSet.
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 |
-Overwrite
N’utilisez pas le champ ETag du paramètre RecordSet pour les vérifications d’accès concurrentiel optimistes.
| 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 |
-RecordSet
Jeu d’enregistrements dans lequel ajouter l’enregistrement.
| Type: | PSPrivateDnsRecordSet |
| 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: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
