Partilhar 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>]

Descrição

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, 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 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 (apenas as operações diretamente no recurso da zona DNS contam como alterações, as operações em conjuntos de registros dentro da zona não). 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 de alterações simultâneas.

Exemplos

Exemplo 1: Remover uma zona

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

Este comando remove a zona denominada myzone.com do grupo de recursos denominado MyResourceGroup.

Parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor padrão:False
Suporta curingas:False
DontShow:False
Pseudónimos:Cf.

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por 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 dos parâmetros

Tipo:IAzureContextContainer
Valor padrão:None
Suporta curingas:False
DontShow:False
Pseudónimos:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-Name

Especifica o nome da zona DNS removida por este cmdlet. Você também deve especificar o parâmetro ResourceGroupName . Como alternativa, você pode especificar a zona DNS usando o parâmetro Zone .

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

Fields
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por 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 (apenas as operações diretamente no recurso da zona DNS contam como alterações, as operações em conjuntos de registros dentro da zona não). 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 de alterações simultâneas.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

Object
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-PassThru

Passthru

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por 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 através do pipeline ou do parâmetro Zone .

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

Fields
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por 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 dos parâmetros

Tipo:SwitchParameter
Valor padrão:False
Suporta curingas:False
DontShow:False
Pseudónimos:Wi

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por 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 através do pipeline. Como alternativa, você pode especificar a zona DNS a ser excluída usando os parâmetros ZoneName e ResourceGroupName .

Propriedades dos parâmetros

Tipo:DnsZone
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

Object
Posição:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por 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

Notas

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