Set-AzDnsZone
Mises à jour les propriétés d’une zone DNS.
Syntax
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
L’applet de commande 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 Confirm 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 Overwrite , 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é 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é 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 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 |
-Name
Spécifie le nom de la zone DNS à mettre à jour.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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 Overwrite , qui met à jour la zone indépendamment des modifications simultanées.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Tag
Paires clé-valeur sous la forme d’une table de hachage. Par exemple : @{key0="value0 » ; key1=$null ; key2="value2"}
Type: | Hashtable |
Aliases: | Tags |
Position: | Named |
Default value: | None |
Required: | False |
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 |
-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 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Entrées
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]]
Sorties
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.
Liens associés
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour