Partager via

Set-AzPrivateDnsZone

  • Référence
Module:
Az.PrivateDns

Met à jour une zone DNS privée à partir d’un groupe de ressources.

Syntaxe

Set-AzPrivateDnsZone
   -ResourceGroupName <String>
   -Name <String>
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzPrivateDnsZone
   -ResourceId <String>
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzPrivateDnsZone
   -PrivateZone <PSPrivateDnsZone>
   [-Tag <Hashtable>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande Set-AzPrivateDnsZone met définitivement à jour une zone DNS (Domain Name System) privée à partir d’un groupe de ressources spécifié. Vous pouvez transmettre un objet PrivateDnsZone à l’aide du paramètre PrivateZone ou à l’aide de l’opérateur de pipeline, ou vous pouvez également spécifier les paramètres Name 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. Lorsque vous spécifiez la zone à l’aide d’un objet PrivateDnsZone (transmis via le pipeline ou paramètre zone), la zone n’est pas mise à jour si elle a été modifiée dans Azure DNS, car l’objet local PrivateDnsZone a été récupéré (seules les opérations directement sur le nombre de ressources de zone DNS en tant que modifications, les opérations sur les jeux d’enregistrements dans la zone ne le font pas). Cela offre une protection pour les modifications simultanées de zone. Cela peut être supprimé à l’aide du paramètre Remplacer, qui met à jour la zone indépendamment des modifications simultanées.

Exemples

Exemple 1 : Met à jour une zone privée

Set-AzPrivateDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup" -Tag @{tag1="value1";tag2="value2"}

Name                          : myzone.com
ResourceId                    : "/subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/PrivateZones/myzone.com"
ResourceGroupName             : MyResourceGroup
Location					  : 
Etag                          : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Tags                          : {tag1="value1";tag2="value2"}
NumberOfRecordSets            : 1
MaxNumberOfRecordSets         : 5000

Cette commande met à jour la zone nommée myzone.com à partir du groupe de ressources nommé MyResourceGroup avec les balises fournies. Utilisez Get-AzPrivateDnsZone pour récupérer la zone mise à jour.

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 privée mise à jour par cette applet de commande. Vous devez également spécifier le paramètre ResourceGroupName. Vous pouvez également spécifier la zone DNS privée à l’aide du paramètre Zone.

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

-Overwrite

Lorsque vous spécifiez la zone à l’aide d’un objet PrivateDnsZone (transmis via le pipeline ou le paramètre Zone), la zone n’est pas mise à jour si elle a été modifiée dans Azure DNS depuis que l’objet local DnsZone a été récupéré (seules les opérations directement sur le nombre de ressources de la zone DNS en tant que modifications, les opérations sur les jeux d’enregistrements dans la zone ne le font pas). Cela offre une protection pour les modifications simultanées de zone. Cela peut être supprimé à l’aide du 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

-PrivateZone

Objet zone à définir.

Type:PSPrivateDnsZone
Position:Named
Valeur par défaut:None
Obligatoire:True
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 DNS privée à l’aide d’un objet DnsZone , transmis via le pipeline ou le paramètre Zone.

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

-ResourceId

ResourceID de zone DNS privée.

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

Table de hachage qui représente les balises de ressource.

Type:Hashtable
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
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.

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

Entrées

String

PSPrivateDnsZone

Sorties

PSPrivateDnsZone