Partager via

Remove-AzPrivateDnsZone

  • Référence
Module:
Az.PrivateDns

Supprime une zone DNS privée d’un groupe de ressources.

Syntaxe

Remove-AzPrivateDnsZone
      -ResourceGroupName <String>
      -Name <String>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzPrivateDnsZone
      -PrivateZone <PSPrivateDnsZone>
      [-Overwrite]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzPrivateDnsZone
      -ResourceId <String>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

L’applet de commande Remove-AzPrivateDnsZone supprime définitivement une zone DNS (Domain Name System) privée d’un groupe de ressources spécifié. Tous les jeux d’enregistrements contenus dans la zone sont également supprimés. Vous pouvez passer 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 le paramètre Zone), la zone n’est pas supprimée si elle a été modifiée dans Azure DNS depuis que l’objet PrivateDnsZone local 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 Overwrite , qui supprime la zone indépendamment des modifications simultanées.

Exemples

Exemple 1 : Supprimer une zone privée

Remove-AzPrivateDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup"

Cette commande supprime la zone nommée myzone.com du groupe de ressources nommé MyResourceGroup.

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: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 supprimée par cette applet de commande. Vous devez également spécifier le paramètre ResourceGroupName . Vous pouvez également spécifier la zone DNS à 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 supprimée si elle a été modifiée dans Azure DNS depuis que l’objet PrivateDnsZone local 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 Overwrite , qui supprime 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

-PassThru

Utilisé pour transmettre le résultat (booléen) de l’opération supprimer la zone privée plus bas dans le pipeline.

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 de zone privée à supprimer.

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 à supprimer. Vous devez également spécifier le paramètre ZoneName . Vous pouvez également spécifier la zone DNS à l’aide d’un objet PrivateDnsZone , 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

DNS privé ResourceID de zone.

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

-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:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

PSPrivateDnsZone

String

Sorties

Boolean