Compartir a través de


Remove-AzPrivateDnsRecordSet

Elimina un conjunto de registros de una zona DNS privada.

Sintaxis

Fields (valor predeterminado)

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

Mixed

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

Object

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

ResourceId

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.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
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

Credenciales, cuenta, inquilino y suscripción usados 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

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

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

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

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

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

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

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

Propiedades de parámetro

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

Tipo de registros DNS privados en el conjunto de registros.

Propiedades de parámetro

Tipo:RecordType
Valor predeterminado:None
Valores aceptados:A, AAAA, CNAME, MX, PTR, SOA, SRV, TXT
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

-ResourceGroupName

Grupo de recursos al que pertenece la zona.

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

-ResourceId

ResourceID de recordSet dns privado.

Propiedades de parámetro

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

Conjuntos de parámetros

ResourceId
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:None
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

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

Propiedades de parámetro

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

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

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

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

PSPrivateDnsZone

PSPrivateDnsRecordSet

String

Salidas

Boolean