Remove-AzDnsZone

  • Référence
Module:
Az.Dns

Supprime une zone DNS d’un groupe de ressources.

Syntax

Remove-AzDnsZone
      -Name <String>
      -ResourceGroupName <String>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzDnsZone
      -Zone <DnsZone>
      [-Overwrite]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

L’applet de commande Remove-AzDnsZone supprime définitivement une zone DNS (Domain Name System) d’un groupe de ressources spécifié. Tous les jeux d’enregistrements contenus dans la zone sont également supprimés. Vous pouvez transmettre un objet DnsZone à l’aide du paramètre Name 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. Lorsque vous spécifiez la zone à l’aide d’un objet DnsZone (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 DnsZone local 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 Overwrite , qui supprime la zone indépendamment des modifications simultanées.

Exemples

Exemple 1 : Supprimer une zone

Remove-AzDnsZone -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
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 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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Overwrite

Lorsque vous spécifiez la zone à l’aide d’un objet DnsZone (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 DnsZone local 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 Overwrite , qui supprime 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

-PassThru

Passthru

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 DnsZone , transmis via le pipeline ou le paramètre Zone .

Type:String
Position:Named
Default value:None
Required:True
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.

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 à supprimer. L’objet DnsZone transmis peut également être transmis via le pipeline. Vous pouvez également spécifier la zone DNS à supprimer à 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

String

DnsZone

Sorties

Boolean

Notes

En raison de l’impact potentiellement élevé de la suppression d’une zone DNS, par défaut, cette applet de commande vous invite à confirmer si la variable $ConfirmPreference Windows PowerShell a une valeur autre que None. 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.