Compartir a través de

Remove-AzDnsRecordConfig

  • Referencia
Módulo:
Az.Dns

Quita un registro DNS de un objeto de conjunto de registros local.

Sintaxis

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Ipv4Address <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Ipv6Address <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Nsdname <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Exchange <String>
      -Preference <UInt16>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Ptrdname <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Value <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Priority <UInt16>
      -Target <String>
      -Port <UInt16>
      -Weight <UInt16>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Cname <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -CaaFlags <Byte>
      -CaaTag <String>
      -CaaValue <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -KeyTag <Int32>
      -Algorithm <Int32>
      -DigestType <Int32>
      -Digest <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Usage <Int32>
      -Selector <Int32>
      -MatchingType <Int32>
      -CertificateAssociationData <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Description

El cmdlet Remove-AzDnsRecordConfig quita un registro del Sistema de nombres de dominio (DNS) de un conjunto de registros. El objeto RecordSet es un objeto sin conexión y los cambios en él no cambian las respuestas DNS hasta después de ejecutar el cmdlet Set-AzDnsRecordSet para conservar el cambio en el servicio DNS de Microsoft Azure. Para quitar un registro, todos los campos de ese tipo de registro deben coincidir exactamente. No se pueden agregar ni quitar registros SOA. Los registros SOA se crean automáticamente cuando se crea una zona DNS y se eliminan automáticamente cuando se elimina la zona DNS. Puede pasar el objeto RecordSet a este cmdlet como parámetro o mediante el operador de canalización.

Ejemplos

Ejemplo 1: Quitar un registro A de un conjunto de registros

$RecordSet = Get-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -RecordSet $RecordSet -Ipv4Address 1.2.3.4
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Ipv4Address 1.2.3.4 | Set-AzDnsRecordSet

En este ejemplo se quita un registro A de un conjunto de registros existente. Si este es el único registro del conjunto de registros, el resultado será un conjunto de registros vacío. Para quitar un conjunto de registros por completo, consulte Remove-AzDnsRecordSet.

Ejemplo 2: Quitar un registro AAAA de un conjunto de registros

$RecordSet = Get-AzDnsRecordSet -Name "www" -RecordType AAAA -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -RecordSet $RecordSet -Ipv6Address 2001:DB80:4009:1803::1005
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "www" -RecordType AAAA -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Ipv6Address 2001:DB80:4009:1803::1005 | Set-AzDnsRecordSet

En este ejemplo se quita un registro AAAA de un conjunto de registros existente. Si este es el único registro del conjunto de registros, el resultado será un conjunto de registros vacío. Para quitar un conjunto de registros por completo, consulte Remove-AzDnsRecordSet.

Ejemplo 3: Quitar un registro CNAME de un conjunto de registros

$RecordSet = Get-AzDnsRecordSet -Name "www" -RecordType CNAME -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -RecordSet $RecordSet -Cname contoso.com
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "www" -RecordType CNAME -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Cname contoso.com | Set-AzDnsRecordSet

En este ejemplo se quita un registro CNAME de un conjunto de registros existente. Dado que un conjunto de registros CNAME puede contener como máximo un registro, el resultado es un conjunto de registros vacío.

Ejemplo 4: Quitar un registro MX de un conjunto de registros

$RecordSet = Get-AzDnsRecordSet -Name "@" -RecordType MX -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -Exchange mail.microsoft.com -Preference 5 -RecordSet $RecordSet
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "@" -RecordType MX -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Exchange mail.microsoft.com -Preference 5 | Set-AzDnsRecordSet

En este ejemplo se quita un registro MX de un conjunto de registros existente. El nombre de registro "@" indica un conjunto de registros en el vértice de la zona. Si este es el único registro del conjunto de registros, el resultado es un conjunto de registros vacío. Para quitar un conjunto de registros por completo, consulte Remove-AzDnsRecordSet.

Ejemplo 5: Quitar un registro NS de un conjunto de registros

$RecordSet = Get-AzDnsRecordSet -Name "abc" -RecordType NS -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -Nsdname ns1.myzone.com -RecordSet $RecordSet
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "abc" -RecordType NS -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Nsdname "ns1.myzone.com" | Set-AzDnsRecordSet

En este ejemplo se quita un registro NS de un conjunto de registros existente. Si este es el único registro del conjunto de registros, el resultado es un conjunto de registros vacío. Para quitar un conjunto de registros por completo, consulte Remove-AzDnsRecordSet.

Ejemplo 6: Quitar un registro PTR de un conjunto de registros

$RecordSet = Get-AzDnsRecordSet -Name "4" -RecordType PTR -ResourceGroupName "MyResourceGroup" -ZoneName 3.2.1.in-addr.arpa
Remove-AzDnsRecordConfig -Ptrdname www.contoso.com -RecordSet $RecordSet
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "4" -RecordType PTR -ResourceGroupName "MyResourceGroup" -ZoneName "3.2.1.in-addr.arpa" | Remove-AzDnsRecordConfig -Ptrdname www.contoso.com | Set-AzDnsRecordSet

En este ejemplo se quita un registro PTR de un conjunto de registros existente. Si este es el único registro del conjunto de registros, el resultado es un conjunto de registros vacío. Para quitar un conjunto de registros por completo, consulte Remove-AzDnsRecordSet.

Ejemplo 7: Quitar un registro SRV de un conjunto de registros

$RecordSet = Get-AzDnsRecordSet -Name "_sip._tcp" -RecordType SRV -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -RecordSet $RecordSet -Priority 0 -Weight 5 -Port 8080 -Target target.example.com
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "_sip._tcp" -RecordType SRV -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Priority 0 -Weight 5 -Port 8080 -Target target.example.com  | Set-AzDnsRecordSet

En este ejemplo se quita un registro SRV de un conjunto de registros existente. Si este es el único registro del conjunto de registros, el resultado es un conjunto de registros vacío. Para quitar un conjunto de registros por completo, consulte Remove-AzDnsRecordSet.

Ejemplo 8: Quitar un registro TXT de un conjunto de registros

$RecordSet = Get-AzDnsRecordSet -Name "text" -RecordType TXT -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -RecordSet $RecordSet -Value "This is a TXT Record"
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "text" -RecordType TXT -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Value "This is a TXT Record"  | Set-AzDnsRecordSet

En este ejemplo se quita un registro TXT de un conjunto de registros existente. Si este es el único registro del conjunto de registros, el resultado es un conjunto de registros vacío. Para quitar un conjunto de registros por completo, consulte Remove-AzDnsRecordSet.

Ejemplo 9: Quitar un registro DS de un conjunto de registros

$RecordSet = Get-AzDnsRecordSet -Name "www" -RecordType DS -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -KeyTag 12345 -Algorithm 3 -DigestType 1 -Digest "49FD46E6C4B45C55D4AC"
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "www" -RecordType DS -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -KeyTag 12345 -Algorithm 3 -DigestType 1 -Digest "49FD46E6C4B45C55D4AC"  | Set-AzDnsRecordSet

En este ejemplo se quita un registro DS de un conjunto de registros existente. Si este es el único registro del conjunto de registros, el resultado es un conjunto de registros vacío. Para quitar un conjunto de registros por completo, consulte Remove-AzDnsRecordSet.

Ejemplo 10: Eliminación de un registro TLSA de un conjunto de registros

$RecordSet = Get-AzDnsRecordSet -Name "_443._tcp.www" -RecordType TLSA -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -Usage 3 -Selector 1 -MatchingType 1 -CertificateAssociationData "49FD46E6C4B45C55D4AC"
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "_443._tcp.www" -RecordType TLSA -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Usage 3 -Selector 1 -MatchingType 1 -CertificateAssociationData "49FD46E6C4B45C55D4AC"  | Set-AzDnsRecordSet

En este ejemplo se quita un registro TLSA de un conjunto de registros existente. Si este es el único registro del conjunto de registros, el resultado es un conjunto de registros vacío. Para quitar un conjunto de registros por completo, consulte Remove-AzDnsRecordSet.

Parámetros

-Algorithm

Campo de algoritmo del registro DS que se va a quitar.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-CaaFlags

Marcas del registro CAA que se va a agregar. Debe ser un número comprendido entre 0 y 255.

Tipo:Byte
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-CaaTag

Campo de etiqueta del registro CAA que se va a agregar.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-CaaValue

Campo de valor del registro CAA que se va a agregar.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-CertificateAssociationData

Campo de datos de asociación de certificado del registro TLSA que se va a quitar.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Cname

Especifica el nombre de dominio de un registro de nombre canónico (CNAME).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
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

-Digest

Campo de resumen del registro DS que se va a quitar.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-DigestType

Campo de tipo de resumen del registro DS que se va a quitar.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Exchange

Especifica el nombre del servidor de intercambio de correo para un registro de intercambio de correo (MX).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Ipv4Address

Especifica una dirección IPv4 para un registro A.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Ipv6Address

Especifica una dirección IPv6 para un registro AAAA.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-KeyTag

Campo de etiqueta de clave del registro DS que se va a quitar.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-MatchingType

Campo de tipo coincidente del registro TLSA que se va a quitar.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Nsdname

Especifica el servidor de nombres para un registro de servidor de nombres (NS).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Port

Especifica el puerto de un registro de servicio (SRV).

Tipo:UInt16
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Preference

Especifica la preferencia de un registro MX.

Tipo:UInt16
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Priority

Especifica la prioridad de un registro SRV.

Tipo:UInt16
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Ptrdname

Especifica el nombre de dominio de destino de un registro de puntero (PTR).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-RecordSet

Especifica el objeto RecordSet que contiene el registro que se va a quitar.

Tipo:DnsRecordSet
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Selector

Campo selector del registro TLSA que se va a quitar.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Target

Especifica el destino de un registro SRV.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Usage

Campo de uso del registro TLSA que se va a quitar.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Value

Especifica el valor de un registro TXT.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Weight

Especifica el peso de un registro SRV.

Tipo:UInt16
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Entradas

DnsRecordSet

String

UInt16

Byte

Salidas

DnsRecordSet