Remove-AzPrivateDnsRecordSet

Módulo:

Az.PrivateDns

Exclui um conjunto de registros de uma zona DNS privada.

Syntax

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. Não é possível excluir registros SOA criados automaticamente no ápice da zona privada. Você pode passar um objeto RecordSet para este cmdlet usando o operador de pipeline ou como um parâmetro ou como um ResourceId. Para identificar um registro definido 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, alternativamente, 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 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 registos

$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, em seguida, armazena-o na variável $RecordSet. O segundo comando remove o registro definido em $RecordSet.

Exemplo 2: Remover um conjunto de registros e suprimir todas as confirmações

$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 entretanto. Os prompts de confirmação são suprimidos.

Parâmetros

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

O nome dos registros no conjunto de registros (relativo ao nome da zona e sem um ponto de encerramento).

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Overwrite

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

Usado para passar o resultado (booleano) da operação excluir zona privada mais abaixo do pipeline.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RecordSet

O conjunto de registros no qual adicionar o registro.

Type:	PSPrivateDnsRecordSet
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-RecordType

O tipo de registros DNS privados no conjunto de registros.

Type:	RecordType
Accepted values:	A, AAAA, CNAME, MX, PTR, SOA, SRV, TXT
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

O grupo de recursos ao qual a zona pertence.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceId

ID de Recursos do Conjunto de Registros DNS Privado.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Zone

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

Type:	PSPrivateDnsZone
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ZoneName

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

PSPrivateDnsZone

PSPrivateDnsRecordSet

String

Saídas

Boolean