Compartilhar via

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 servidor de nomes (NS) que são 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, 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 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-AzDnsRecordSet -Name "www" -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordSet -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-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 enquanto isso. Os prompts de confirmação são suprimidos.

Parâmetros

-Confirm

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DefaultProfile

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

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

Especifica o nome do RecordSet a ser removido. Ao especificar o conjunto de registros 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 do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Fields
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
Mixed
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Overwrite

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 do Azure desde que o objeto RecordSet local 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 do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Object
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PassThru

passthru

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RecordSet

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

Propriedades do parâmetro

Tipo:DnsRecordSet
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Object
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 do parâmetro

Tipo:RecordType
Valor padrão:None
Valores aceitos:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Fields
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
Mixed
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ResourceGroupName

Especifica o grupo de recursos que contém a zona DNS que contém o RecordSet a ser excluído. Esse 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 Nome e Zona .

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Fields
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-WhatIf

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Zone

Especifica a zona DNS que contém o RecordSet a ser excluído. Esse 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 do parâmetro

Tipo:DnsZone
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Mixed
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 Nome e Zona .

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Fields
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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

Observações

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