Remove-AzPrivateDnsRecordSet

Módulo:

Az.PrivateDns

Elimina un conjunto de registros de una zona DNS privada.

Sintaxis

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

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

Remove-AzPrivateDnsRecordSet
      -RecordSet <PSPrivateDnsRecordSet>
      [-Overwrite]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-AzPrivateDnsRecordSet
      -ResourceId <String>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

El cmdlet Remove-AzPrivateDnsRecordSet elimina el conjunto de registros especificado de la zona especificada. No se pueden eliminar registros SOA que se crean automáticamente en el vértice de la zona privada. Puede pasar un objeto RecordSet a este cmdlet mediante el operador de canalización o como parámetro o como ResourceId. Para identificar un conjunto de registros por nombre y tipo sin usar un objeto RecordSet, debe pasar la zona como un objeto PSPrivateDnsZone 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 DNS privado de Azure 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-AzPrivateDnsRecordSet -Name "www" -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzPrivateDnsRecordSet -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-AzPrivateDnsRecordSet -Name "www" -ZoneName "myzone.com" -ResourceGroupName "MyResourceGroup"
Remove-AzPrivateDnsRecordSet -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-AzPrivateDnsRecordSet -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.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
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

-Name

Nombre de los registros del conjunto de registros (relativo al nombre de la zona y sin un punto de terminación).

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

-Overwrite

No use el campo ETag del parámetro RecordSet para las comprobaciones de simultaneidad optimista.

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

-PassThru

Se usa para pasar el resultado (booleano) de la operación eliminar la zona privada más abajo de la canalización.

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

-RecordSet

Conjunto de registros en el que se va a agregar el registro.

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

-RecordType

Tipo de registros DNS privados en el conjunto de registros.

Tipo:	RecordType
Valores aceptados:	A, AAAA, CNAME, MX, PTR, SOA, SRV, TXT
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ResourceGroupName

Grupo de recursos al que pertenece la zona.

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

-ResourceId

ResourceID de recordSet dns privado.

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

-WhatIf

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

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Zone

Objeto PrivateDnsZone que representa la zona en la que se va a crear el conjunto de registros.

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

-ZoneName

Zona en la que existe el conjunto de registros (sin un punto de terminación).

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

Entradas

PSPrivateDnsZone

PSPrivateDnsRecordSet

String

Salidas

Boolean