Remove-AzPrivateDnsRecordSet

Módulo:

Az.PrivateDns

Exclui um conjunto de registros de uma zona DNS privada.

Sintaxe

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

O cmdlet Remove-AzPrivateDnsRecordSet exclui o conjunto de registros especificado da zona especificada. Você não pode excluir registros SOA que são criados automaticamente no ápice da zona privada. Você pode passar um objeto RecordSet para esse cmdlet usando o operador de pipeline ou como um parâmetro ou como um ResourceId. Para identificar um conjunto de registros por nome e tipo sem usar um objeto RecordSet, você deve passar a zona como um objeto PSPrivateDnsZone para esse cmdlet usando o operador de pipeline ou como um parâmetro ou, como alternativa, você pode especificar os parâmetros ZoneName e ResourceGroupName. Você pode usar o parâmetro Confirm e $ConfirmPreference variável do Windows PowerShell para controlar se o cmdlet solicita confirmação. Ao especificar o conjunto de registros usando um objeto RecordSet, o conjunto de registros não será excluído se ele tiver sido alterado no DNS privado do Azure desde que o objeto RecordSet local foi recuperado. Isso fornece proteção para alterações simultâneas. Você pode suprimir isso usando o parâmetro Overwrite, que exclui o conjunto de registros, independentemente das alterações simultâneas.

Exemplos

Exemplo 1: remover um conjunto de registros

$RecordSet = Get-AzPrivateDnsRecordSet -Name "www" -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzPrivateDnsRecordSet -RecordSet $RecordSet

O primeiro comando obtém o conjunto de registros especificado e o armazena na variável $RecordSet. O segundo comando remove o conjunto de registros em $RecordSet.

Exemplo 2: remover um conjunto de registros e suprimir toda a confirmação

$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

O primeiro comando obtém o conjunto de registros especificado. O segundo comando exclui o conjunto de registros, mesmo que ele tenha sido alterado enquanto isso. Os prompts de confirmação são suprimidos.

Parâmetros

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Name

O nome dos registros no conjunto de registros (em relação ao nome da zona e sem um ponto de encerramento).

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Overwrite

Não use o campo ETag do parâmetro RecordSet para verificações de simultaneidade otimistas.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PassThru

Usado para passar o resultado (booliano) da operação, exclua a zona privada mais abaixo do pipeline.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RecordSet

O conjunto de registros no qual adicionar o registro.

Tipo:	PSPrivateDnsRecordSet
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-RecordType

O tipo de registros DNS privados no conjunto de registros.

Tipo:	RecordType
Valores aceitos:	A, AAAA, CNAME, MX, PTR, SOA, SRV, TXT
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ResourceGroupName

O grupo de recursos ao qual a zona pertence.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ResourceId

ResourceID do Conjunto de Registros DNS Privado.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:	SwitchParameter
Aliases:	wi
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Zone

O objeto PrivateDnsZone que representa a zona na qual criar o conjunto de registros.

Tipo:	PSPrivateDnsZone
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-ZoneName

A zona na qual o conjunto de registros existe (sem um ponto de encerramento).

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Entradas

PSPrivateDnsZone

PSPrivateDnsRecordSet

String

Saídas

Boolean