Remove-AzDnsRecordSet

Módulo:
Az.Dns Module

Exclui um conjunto de registros.

Sintaxe

Fields 

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

Mixed 

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

Object 

Remove-AzDnsRecordSet
    -RecordSet <DnsRecordSet>
    [-Overwrite]
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O cmdlet Remove-AzDnsRecordSet exclui o conjunto de registros especificado da zona especificada. Não é possível excluir registros SOA ou de servidor de nomes (NS) criados automaticamente no ápice da zona. Você pode passar um objeto RecordSet para esse cmdlet usando o operador de pipeline ou como um parâmetro. Para identificar um conjunto de registros por nome e tipo sem usar um objeto RecordSet , você deve passar a zona como um objeto DnsZone para esse cmdlet usando o operador de pipeline ou como um parâmetro ou, alternativamente, pode especificar os parâmetros ZoneName e ResourceGroupName . Podes usar o parâmetro Confirmar e $ConfirmPreference Windows variável PowerShell para controlar se o cmdlet te pede confirmação. Ao especificar o conjunto de registos usando um objeto RecordSet, o conjunto de registos não é eliminado se tiver sido alterado em Azure DNS desde que o objeto local RecordSet 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-AzDnsRecordSet -Name "www" -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordSet -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-AzDnsRecordSet -Name "www" -ZoneName "myzone.com" -ResourceGroupName "MyResourceGroup"
Remove-AzDnsRecordSet -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-AzDnsRecordSet -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 confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DefaultProfile

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

Propriedades dos parâmetros

Tipo:IAzureContextContainer
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

Especifica o nome do RecordSet a ser removido. Ao especificar o registro definido por nome, a zona DNS deve ser especificada usando o parâmetro Zone ou os parâmetros ZoneName e ResourceGroupName . Como alternativa, o conjunto de registros pode ser especificado usando um objeto RecordSet , passado usando o parâmetro RecordSet .

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Fields
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
Mixed
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Overwrite

Ao especificar o conjunto de registos usando um objeto RecordSet, o conjunto de registos não é eliminado se tiver sido alterado em Azure DNS desde que o objeto local RecordSet foi recuperado. Isso fornece proteção para alterações simultâneas. Isso pode ser suprimido usando o parâmetro Overwrite , que exclui o conjunto de registros independentemente das alterações simultâneas.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Object
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PassThru

Passthru

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-RecordSet

Especifica o objeto RecordSet a ser removido. Como alternativa, o conjunto de registros pode ser especificado usando os parâmetros Name e Zone ou usando os parâmetros Name, ZoneName e ResourceGroupName .

Propriedades dos parâmetros

Tipo:DnsRecordSet
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Object
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-RecordType

Especifica o tipo de registro DNS. Os valores válidos são:

  • A
  • AAAA
  • CNAME
  • MX
  • NAPTR
  • NS
  • PTR
  • SRV
  • Os registros SOA TXT são excluídos automaticamente quando a zona é excluída. Não é possível excluir manualmente os registros SOA.

Propriedades dos parâmetros

Tipo:RecordType
Default value:None
Valores aceites:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Fields
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
Mixed
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-ResourceGroupName

Especifica o grupo de recursos que contém a zona DNS que contém o RecordSet a ser excluído. Este parâmetro é aplicável somente quando o conjunto de registros e a zona DNS são especificados usando os parâmetros Name e ZoneName . Como alternativa, você pode especificar o conjunto de registros usando o parâmetro RecordSet ou os parâmetros Name e Zone .

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Fields
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-WhatIf

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Wi

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Zone

Especifica a zona DNS que contém o RecordSet a ser excluído. Este parâmetro é aplicável somente ao especificar o conjunto de registros usando o parâmetro Name . Como alternativa, você pode especificar o conjunto de registros usando o parâmetro RecordSet ou os parâmetros Name, ZoneName e ResourceGroupName .

Propriedades dos parâmetros

Tipo:DnsZone
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Mixed
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ZoneName

Especifica o nome da zona que contém o RecordSet a ser excluído. Você também deve especificar os parâmetros Name e ResourceGroupName . Como alternativa, o conjunto de registros pode ser especificado usando o parâmetro RecordSet ou os parâmetros Name e Zone .

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Fields
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

RecordType

String

DnsZone

DnsRecordSet

Saídas

Boolean

Notas

Você pode usar o parâmetro Confirm para controlar se esse cmdlet solicita confirmação. Por defeito, o cmdlet solicita-te confirmação se a variável PowerShell $ConfirmPreference Windows tem valor Médio ou inferior. Se você especificar Confirm ou Confirm:$True, esse cmdlet solicitará a confirmação antes de ser executado. Se você especificar Confirm:$False, o cmdlet não solicitará a confirmação.