Compartilhar via

Remove-AzPrivateDnsZone

  • Referência
Módulo:
Az.PrivateDns

Remove uma zona DNS privada de um grupo de recursos.

Sintaxe

Remove-AzPrivateDnsZone
      -ResourceGroupName <String>
      -Name <String>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzPrivateDnsZone
      -PrivateZone <PSPrivateDnsZone>
      [-Overwrite]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzPrivateDnsZone
      -ResourceId <String>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Remove-AzPrivateDnsZone exclui permanentemente uma zona DNS (Sistema de Nomes de Domínio) privada 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 PrivateDnsZone usando o parâmetro PrivateZone ou usando o operador de pipeline ou, como alternativa, você pode especificar os parâmetros de Nome 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 PrivateDnsZone (passado por meio do pipeline ou do parâmetro zona ), a zona não será excluída se tiver sido alterada no DNS do Azure desde que o objeto PrivateDnsZone do local foi recuperado (somente operações diretamente na contagem de recursos de zona DNS 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 Substituir, que exclui a zona independentemente das alterações simultâneas.

Exemplos

Exemplo 1: remover uma zona privada

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

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

Parâmetros

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica o nome da zona DNS privada 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 zona .

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Overwrite

Ao especificar a zona usando um objeto PrivateDnsZone (passado por meio do pipeline ou do parâmetro zona ), a zona não será excluída se tiver sido alterada no DNS do Azure desde que o objeto PrivateDnsZone do local foi recuperado (somente operações diretamente na contagem de recursos de zona DNS 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 Substituir, que exclui a zona independentemente das alterações simultâneas.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PassThru

Usado para passar o resultado (booliano) da operação, exclua a zona privada mais abaixo do pipeline.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PrivateZone

O objeto de zona privada a ser excluído.

Tipo:PSPrivateDnsZone
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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 PrivateDnsZone, passado por meio do pipeline ou do parâmetro zona .

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResourceId

ResourceID de zona DNS privada.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

PSPrivateDnsZone

String

Saídas

Boolean