Compartir a través de

Remove-AzDnsZone

  • Referencia
Módulo:
Az.Dns

Quita una zona DNS de un grupo de recursos.

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

El cmdlet Remove-AzDnsZone elimina permanentemente una zona del sistema de nombres de dominio (DNS) de un grupo de recursos especificado. Todos los conjuntos de registros contenidos en la zona también se eliminan. Puede pasar un objeto DnsZone mediante el parámetro Name o mediante el operador de canalización, o bien puede especificar los parámetros ZoneName y ResourceGroupName . Puede usar el parámetro Confirm y $ConfirmPreference variable de Windows PowerShell para controlar si el cmdlet le pide confirmación. Al especificar la zona mediante un objeto DnsZone (pasado a través de la canalización o el parámetro Zone), la zona no se elimina si se ha cambiado en Azure DNS desde que se recuperó el objeto DnsZone local (solo se recuperaron las operaciones directamente en el recuento de recursos de zona DNS como cambios, las operaciones en conjuntos de registros dentro de la zona no). Esto proporciona protección para los cambios simultáneos en la zona. Esto se puede suprimir mediante el parámetro Overwrite , que elimina la zona independientemente de los cambios simultáneos.

Ejemplos

Ejemplo 1: Quitar una zona

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

Este comando quita la zona denominada myzone.com del grupo de recursos denominado MyResourceGroup.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
valor predeterminado:False
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica el nombre de la zona DNS que quita este cmdlet. También debe especificar el parámetro ResourceGroupName . Como alternativa, puede especificar la zona DNS mediante el parámetro Zone .

Tipo:String
Position:Named
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

-Overwrite

Al especificar la zona mediante un objeto DnsZone (pasado a través de la canalización o el parámetro Zone), la zona no se elimina si se ha cambiado en Azure DNS desde que se recuperó el objeto DnsZone local (solo se recuperaron las operaciones directamente en el recuento de recursos de zona DNS como cambios, las operaciones en conjuntos de registros dentro de la zona no). Esto proporciona protección para los cambios simultáneos en la zona. Esto se puede suprimir mediante el parámetro Overwrite , que elimina la zona independientemente de los cambios simultáneos.

Tipo:SwitchParameter
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Passthru

Tipo:SwitchParameter
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Especifica el nombre del grupo de recursos que contiene la zona que se va a quitar. También debe especificar el parámetro ZoneName . Como alternativa, puede especificar la zona DNS mediante un objeto DnsZone , pasado a través de la canalización o el parámetro Zone .

Tipo:String
Position:Named
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Aliases:wi
Position:Named
valor predeterminado:False
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-Zone

Especifica la zona DNS que se va a eliminar. El objeto DnsZone pasado también se puede pasar a través de la canalización. Como alternativa, puede especificar la zona DNS que se va a eliminar mediante los parámetros ZoneName y ResourceGroupName .

Tipo:DnsZone
Position:Named
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

Entradas

String

DnsZone

Salidas

Boolean

Notas

Debido al impacto potencialmente alto de eliminar una zona DNS, de forma predeterminada, este cmdlet solicita confirmación si la variable de Windows PowerShell de $ConfirmPreference tiene cualquier valor distinto de None. Si especifica Confirm o Confirm:$True, este cmdlet le pedirá confirmación antes de que se ejecute. Si especifica Confirm:$False, el cmdlet no le pide confirmación.