Condividi tramite

Remove-AzDnsZone

  • Riferimento
Modulo:
Az.Dns

Rimuove una zona DNS da un gruppo di risorse.

Sintassi

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

Descrizione

Il cmdlet Remove-AzDnsZone elimina definitivamente una zona DNS (Domain Name System) da un gruppo di risorse specificato. Vengono eliminati anche tutti i set di record contenuti nella zona. È possibile passare un oggetto DnsZone usando il parametro Name oppure usando l'operatore pipeline oppure specificare i parametri ZoneName e ResourceGroupName. È possibile usare il parametro Confirm e $ConfirmPreference variabile di Windows PowerShell per controllare se il cmdlet richiede la conferma. Quando si specifica la zona usando un oggetto dnsZone (passato tramite la pipeline o il parametro zona di), la zona non viene eliminata se è stata modificata in DNS di Azure dal momento che l'oggetto DnsZone locale è stato recuperato (solo le operazioni direttamente sul numero di risorse della zona DNS come modifiche, le operazioni sui set di record all'interno della zona non vengono recuperate). Ciò garantisce la protezione per le modifiche simultanee della zona. Questa operazione può essere eliminata usando il parametro Sovrascrivi, che elimina la zona indipendentemente dalle modifiche simultanee.

Esempio

Esempio 1: Rimuovere una zona

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

Questo comando rimuove la zona denominata myzone.com dal gruppo di risorse denominato MyResourceGroup.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specifica il nome della zona DNS rimossa da questo cmdlet. È inoltre necessario specificare il parametro ResourceGroupName. In alternativa, è possibile specificare la zona DNS usando il parametro zona.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Overwrite

Quando si specifica la zona usando un oggetto dnsZone (passato tramite la pipeline o il parametro zona di), la zona non viene eliminata se è stata modificata in DNS di Azure dal momento che l'oggetto DnsZone locale è stato recuperato (solo le operazioni direttamente sul numero di risorse della zona DNS come modifiche, le operazioni sui set di record all'interno della zona non vengono recuperate). Ciò garantisce la protezione per le modifiche simultanee della zona. Questa operazione può essere eliminata usando il parametro Sovrascrivi, che elimina la zona indipendentemente dalle modifiche simultanee.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PassThru

passthru

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ResourceGroupName

Specifica il nome del gruppo di risorse che contiene la zona da rimuovere. È inoltre necessario specificare il parametro ZoneName. In alternativa, è possibile specificare la zona DNS usando un oggetto dnsZone , passato tramite la pipeline o il parametro Zone.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Zone

Specifica la zona DNS da eliminare. L'oggetto dnsZone passato può essere passato anche tramite la pipeline. In alternativa, è possibile specificare la zona DNS da eliminare usando i parametri ZoneName e ResourceGroupName.

Tipo:DnsZone
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

Output

Note

A causa dell'impatto potenzialmente elevato dell'eliminazione di una zona DNS, per impostazione predefinita, questo cmdlet richiede la conferma se la variabile di Windows PowerShell $ConfirmPreference ha un valore diverso da Nessuno. Se si specifica Confirm o Confirm:$True, questo cmdlet richiede conferma prima dell'esecuzione. Se si specifica Confirm:$False, il cmdlet non richiede la conferma.