Compartilhar via

Remove-AzDnsZone

Módulo:
Az.Dns Module

Remove uma zona DNS de um grupo de recursos.

Sintaxe

Fields 

Remove-AzDnsZone
    -Name <String>
    -ResourceGroupName <String>
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Object 

Remove-AzDnsZone
    -Zone <DnsZone>
    [-Overwrite]
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O cmdlet Remove-AzDnsZone exclui permanentemente uma zona DNS (Sistema de Nomes de Domínio) de um grupo de recursos especificado. Todos os conjuntos de registros contidos na zona também são excluídos. Você pode passar um objeto DnsZone usando o parâmetro Name ou usando o operador de pipeline ou, como alternativa, 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 a zona usando um objeto DnsZone (passado por meio do pipeline ou do parâmetro Zone ), a zona não será excluída se tiver sido alterada no DNS do Azure desde que o objeto DnsZone local foi recuperado (somente operações diretamente na contagem de recursos da zona DNS como alterações, as operações em conjuntos de registros dentro da zona não o fazem). Isso fornece proteção para alterações de zona simultâneas. Isso pode ser suprimido usando o parâmetro Overwrite , que exclui a zona independentemente das alterações simultâneas.

Exemplos

Exemplo 1: remover uma zona

Remove-AzDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup"

Esse comando remove a zona chamada myzone.com do grupo de recursos chamado MyResourceGroup.

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 da zona DNS que esse cmdlet remove. Você também deve especificar o parâmetro ResourceGroupName . Como alternativa, você pode especificar a zona DNS usando o parâmetro Zone .

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

-Overwrite

Ao especificar a zona usando um objeto DnsZone (passado por meio do pipeline ou do parâmetro Zone ), a zona não será excluída se tiver sido alterada no DNS do Azure desde que o objeto DnsZone local foi recuperado (somente operações diretamente na contagem de recursos da zona DNS como alterações, as operações em conjuntos de registros dentro da zona não o fazem). Isso fornece proteção para alterações de zona simultâneas. Isso pode ser suprimido usando o parâmetro Overwrite , que exclui a zona 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

-ResourceGroupName

Especifica o nome do grupo de recursos que contém a zona a ser removida. Você também deve especificar o parâmetro ZoneName . Como alternativa, você pode especificar a zona DNS usando um objeto DnsZone , passado por meio do pipeline ou do parâmetro Zone .

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 a ser excluída. O objeto DnsZone passado também pode ser passado por meio do pipeline. Como alternativa, você pode especificar a zona DNS a ser excluída usando os parâmetros ZoneName e ResourceGroupName .

Propriedades do parâmetro

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

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

String

DnsZone

Saídas

Boolean

Observações

Devido ao impacto potencialmente alto da exclusão de uma zona DNS, por padrão, esse cmdlet solicitará confirmação se a variável $ConfirmPreference Windows PowerShell tiver qualquer valor diferente de None. 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.