Compartir a través de

Remove-AzDnsZone

Módulo:
Az.Dns Module

Quita una zona DNS de un grupo de recursos.

Sintaxis

Fields 

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

Object 

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 pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DefaultProfile

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

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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 .

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Fields
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Object
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PassThru

passthru

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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 .

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Fields
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-WhatIf

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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 .

Propiedades de parámetro

Tipo:DnsZone
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Object
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

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.