Remove-AzDnsRecordConfig
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-AzDnsRecordSetEn 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-AzDnsRecordSetEn 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-AzDnsRecordSetEn 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-AzDnsRecordSetEn 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-AzDnsRecordSetEn 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-AzDnsRecordSetEn 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-AzDnsRecordSetEn 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-AzDnsRecordSetEn 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-AzDnsRecordSetEn 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-AzDnsRecordSetEn 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
Salidas
Vínculos relacionados
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de