Compartir a través de

Remove-AzDnsZone

  • Referencia
Módulo:
Az.Dns

Quita una zona DNS de un grupo de recursos.

Sintaxis

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
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PassThru

passthru

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.