Partager via

Set-AzDnsZone

  • Référence
Module:
Az.Dns

Met à jour les propriétés d’une zone DNS.

Syntaxe

Set-AzDnsZone
   -Name <String>
   -ResourceGroupName <String>
   [-Tag <Hashtable>]
   [-RegistrationVirtualNetworkId <System.Collections.Generic.List`1[System.String]>]
   [-ResolutionVirtualNetworkId <System.Collections.Generic.List`1[System.String]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzDnsZone
   -Name <String>
   -ResourceGroupName <String>
   [-Tag <Hashtable>]
   [-RegistrationVirtualNetwork <System.Collections.Generic.List`1[Microsoft.Azure.Management.Internal.Network.Common.IResourceReference]>]
   [-ResolutionVirtualNetwork <System.Collections.Generic.List`1[Microsoft.Azure.Management.Internal.Network.Common.IResourceReference]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzDnsZone
   -Zone <DnsZone>
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

La cmdlet Set-AzDnsZone met à jour la zone DNS spécifiée dans le service Azure DNS. Cette applet de commande ne met pas à jour les jeux d’enregistrements dans la zone. Vous pouvez passer un objet DnsZone en tant que paramètre ou à l’aide de l’opérateur de pipeline, ou vous pouvez également spécifier les paramètres ZoneName et ResourceGroupName. Vous pouvez utiliser le paramètre Confirmer et $ConfirmPreference variable Windows PowerShell pour contrôler si l’applet de commande vous invite à confirmer. Lors du passage d’une zone DNS en tant qu’objet (à l’aide de l’objet Zone ou via le pipeline), elle n’est pas mise à jour si elle a été modifiée dans Azure DNS depuis la récupération de l’objet DnsZone local. Cela offre une protection pour les modifications simultanées. Vous pouvez supprimer ce comportement avec le paramètre Remplacer, qui met à jour la zone indépendamment des modifications simultanées.

Exemples

Exemple 1 : Mettre à jour une zone DNS

$Zone = Get-AzDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup"
$Zone.Tags = @(@{"Name"="Dept"; "Value"="Electrical"})
Set-AzDnsZone -Zone $Zone

La première commande obtient la zone nommée myzone.com à partir du groupe de ressources spécifié, puis la stocke dans la variable $Zone. La deuxième commande met à jour les balises pour $Zone. La commande finale valide la modification.

Exemple 2 : Mettre à jour des balises pour une zone

Set-AzDnsZone -ResourceGroupName "MyResourceGroup" -Name "myzone.com" -Tag @(@{"Name"="Dept"; "Value"="Electrical"})

Cette commande met à jour les balises de la zone nommée myzone.com sans obtenir explicitement la zone.

Exemple 3 : Association d’une zone privée à un réseau virtuel en spécifiant son ID

$vnet = Get-AzVirtualNetwork -ResourceGroupName "MyResourceGroup" -Name "myvnet"
Set-AzDnsZone -ResourceGroupName "MyResourceGroup" -Name "myprivatezone.com" -RegistrationVirtualNetworkId @($vnet.Id)

Cette commande associe la zone DNS privée myprivatezone.com au réseau virtuel myvnet en tant que réseau d’inscription en spécifiant son ID.

Exemple 4 : Association d’une zone privée à un réseau virtuel en spécifiant l’objet réseau.

$vnet = Get-AzVirtualNetwork -ResourceGroupName "MyResourceGroup" -Name "myvnet"
Set-AzDnsZone -ResourceGroupName "MyResourceGroup" -Name "myprivatezone.com" -RegistrationVirtualNetwork @($vnet)

Cette commande associe la zone DNS privée myprivatezone.com au réseau virtuel myvnet en tant que réseau d’inscription en passant l’objet de réseau virtuel représenté par $vnet variable à l’applet de commande Set-AzDnsZone.

Paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

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

-Name

Spécifie le nom de la zone DNS à mettre à jour.

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

-Overwrite

Lors du passage d’une zone DNS en tant qu’objet (à l’aide de l’objet Zone ou via le pipeline), elle n’est pas mise à jour si elle a été modifiée dans Azure DNS depuis la récupération de l’objet DnsZone local. Cela offre une protection pour les modifications simultanées. Vous pouvez supprimer ce comportement avec le paramètre Remplacer, qui met à jour la zone indépendamment des modifications simultanées.

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

-RegistrationVirtualNetwork

Liste des réseaux virtuels qui inscrivent des enregistrements de noms d’hôte de machine virtuelle dans cette zone DNS, disponibles uniquement pour les zones privées.

Type:List<T>[IResourceReference]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-RegistrationVirtualNetworkId

Liste des ID de réseau virtuel qui inscrivent des enregistrements de noms d’hôte de machine virtuelle dans cette zone DNS, disponibles uniquement pour les zones privées.

Type:List<T>[String]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ResolutionVirtualNetwork

La liste des réseaux virtuels en mesure de résoudre les enregistrements dans cette zone DNS, disponible uniquement pour les zones privées.

Type:List<T>[IResourceReference]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ResolutionVirtualNetworkId

Liste des ID de réseau virtuel capables de résoudre les enregistrements dans cette zone DNS, disponibles uniquement pour les zones privées.

Type:List<T>[String]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ResourceGroupName

Spécifie le nom du groupe de ressources qui contient la zone à mettre à jour. Vous devez également spécifier le paramètre ZoneName. Vous pouvez également spécifier la zone à l’aide d’un objet DnsZone avec le paramètre zone ou le pipeline.

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

-Tag

Paires clé-valeur sous la forme d’une table de hachage. Par exemple : @{key0="value0 » ; key1=$null ; key2="value2"}

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

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. 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
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Zone

Spécifie la zone DNS à mettre à jour. Vous pouvez également spécifier la zone à l’aide des paramètres ZoneName et ResourceGroupName.

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

Entrées

String

Hashtable

List<T>[[System.String, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

List<T>[[Microsoft.Azure.Management.Internal.Network.Common.IResourceReference, Microsoft.Azure.PowerShell.Clients.Network, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

DnsZone

Sorties

DnsZone

Notes

Vous pouvez utiliser le paramètre Confirmer 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 Confirmer 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.