Compartir a través de

Remove-AzDnsRecordConfig

  • Referencia
Módulo:
Az.Dns

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

Syntax

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
Position:Named
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

-CaaFlags

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

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

-CaaTag

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

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

-CaaValue

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

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

-CertificateAssociationData

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

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

-Cname

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

Tipo:String
Position:Named
valor predeterminado:None
Requerido:True
Accept pipeline input:True
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

-Digest

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

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

-DigestType

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

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

-Exchange

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

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

-Ipv4Address

Especifica una dirección IPv4 para un registro A.

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

-Ipv6Address

Especifica una dirección IPv6 para un registro AAAA.

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

-KeyTag

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

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

-MatchingType

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

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

-Nsdname

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

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

-Port

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

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

-Preference

Especifica la preferencia de un registro MX.

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

-Priority

Especifica la prioridad de un registro SRV.

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

-Ptrdname

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

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

-RecordSet

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

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

-Selector

Campo selector del registro TLSA que se va a quitar.

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

-Target

Especifica el destino de un registro SRV.

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

-Usage

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

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

-Value

Especifica el valor de un registro TXT.

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

-Weight

Especifica el peso de un registro SRV.

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

Entradas

DnsRecordSet

String

UInt16

Byte

Salidas

DnsRecordSet