Compartir a través de

Remove-AzDnsRecordSet

Módulo:
Az.Dns Module

Elimina un conjunto de registros.

Sintaxis

Fields 

Remove-AzDnsRecordSet
    -Name <String>
    -RecordType <RecordType>
    -ZoneName <String>
    -ResourceGroupName <String>
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Mixed 

Remove-AzDnsRecordSet
    -Name <String>
    -RecordType <RecordType>
    -Zone <DnsZone>
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Object 

Remove-AzDnsRecordSet
    -RecordSet <DnsRecordSet>
    [-Overwrite]
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

El cmdlet Remove-AzDnsRecordSet elimina el conjunto de registros especificado de la zona especificada. No se pueden eliminar registros soa o servidor de nombres (NS) que se crean automáticamente en el vértice de zona. Puede pasar un objeto RecordSet a este cmdlet mediante el operador de canalización o como parámetro. Para identificar un conjunto de registros por nombre y tipo sin usar un objeto RecordSet , debe pasar la zona como un objeto DnsZone a este cmdlet mediante el operador de canalización o como parámetro, 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 el conjunto de registros mediante un objeto RecordSet , el conjunto de registros no se elimina si se ha cambiado en Azure DNS desde que se recuperó el objeto RecordSet local. Esto proporciona protección para los cambios simultáneos. Puede suprimirlo mediante el parámetro Overwrite , que elimina el conjunto de registros independientemente de los cambios simultáneos.

Ejemplos

Ejemplo 1: Quitar un conjunto de registros

$RecordSet = Get-AzDnsRecordSet -Name "www" -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordSet -RecordSet $RecordSet

El primer comando obtiene el conjunto de registros especificado y, a continuación, lo almacena en la variable $RecordSet. El segundo comando quita el conjunto de registros en $RecordSet.

Ejemplo 2: Quitar un conjunto de registros y suprimir toda la confirmación

$RecordSet = Get-AzDnsRecordSet -Name "www" -ZoneName "myzone.com" -ResourceGroupName "MyResourceGroup"
Remove-AzDnsRecordSet -RecordSet $RecordSet -Confirm:$False -Overwrite

# Alternatively, the record set can be removed as follows.  In this case,
# because the record set is specified by name rather than by object, the
# Overwrite parameter is not applicable.

Remove-AzDnsRecordSet -Name "www" -ZoneName "myzone.com" -ResourceGroupName "MyResourceGroup" -Confirm:$False

El primer comando obtiene el conjunto de registros especificado. El segundo comando elimina el conjunto de registros, aunque haya cambiado mientras tanto. Se suprimen los mensajes de confirmación.

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 del objeto RecordSet que se va a quitar. Al especificar el conjunto de registros por nombre, se debe especificar la zona DNS mediante el parámetro Zone o los parámetros ZoneName y ResourceGroupName . Como alternativa, el conjunto de registros se puede especificar mediante un objeto RecordSet , pasado mediante el parámetro RecordSet .

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

-Overwrite

Al especificar el conjunto de registros mediante un objeto RecordSet , el conjunto de registros no se elimina si se ha cambiado en Azure DNS desde que se recuperó el objeto RecordSet local. Esto proporciona protección para los cambios simultáneos. Esto se puede suprimir mediante el parámetro Overwrite , que elimina el conjunto de registros 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

-RecordSet

Especifica el objeto RecordSet que se va a quitar. Como alternativa, el conjunto de registros se puede especificar mediante los parámetros Name y Zone , o mediante los parámetros Name, ZoneName y ResourceGroupName .

Propiedades de parámetro

Tipo:DnsRecordSet
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

-RecordType

Especifica el tipo de registro DNS. Los valores válidos son:

  • A
  • AAAA
  • CNAME
  • México
  • NAPTR
  • NS
  • PTR
  • SRV
  • Los registros SOA TXT se eliminan automáticamente cuando se elimina la zona. No se pueden eliminar manualmente registros SOA.

Propiedades de parámetro

Tipo:RecordType
Valor predeterminado:None
Valores aceptados:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
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
Mixed
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

-ResourceGroupName

Especifica el grupo de recursos que contiene la zona DNS que contiene el objeto RecordSet que se va a eliminar. Este parámetro solo es aplicable cuando se especifica el conjunto de registros y la zona DNS mediante los parámetros Name y ZoneName . Como alternativa, puede especificar el conjunto de registros mediante el parámetro RecordSet o los parámetros Name y 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 contiene el objeto RecordSet que se va a eliminar. Este parámetro solo es aplicable al especificar el conjunto de registros mediante el parámetro Name . Como alternativa, puede especificar el conjunto de registros mediante el parámetro RecordSet o los parámetros Name, ZoneName y ResourceGroupName .

Propiedades de parámetro

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

Conjuntos de parámetros

Mixed
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

-ZoneName

Especifica el nombre de la zona que contiene el objeto RecordSet que se va a eliminar. También debe especificar los parámetros Name y ResourceGroupName . Como alternativa, el conjunto de registros se puede especificar mediante el parámetro RecordSet o los parámetros Name y 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

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

RecordType

String

DnsZone

DnsRecordSet

Salidas

Boolean

Notas

Puede usar el parámetro Confirm para controlar si este cmdlet le pide confirmación. De forma predeterminada, el cmdlet le pide confirmación si la variable de Windows PowerShell $ConfirmPreference tiene un valor de Medium o lower. 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.