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 o usando l'operatore della pipeline oppure, in alternativa, è possibile 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 Zone), la zona non viene eliminata se è stata modificata in DNS di Azure perché l'oggetto DnsZone locale è stato recuperato (solo le operazioni direttamente sulla risorsa della zona DNS vengono conteggiate come modifiche, le operazioni sui set di record all'interno della zona non lo fanno). 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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 Zone .

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Overwrite

Quando si specifica la zona usando un oggetto DnsZone (passato tramite la pipeline o il parametro Zone), la zona non viene eliminata se è stata modificata in DNS di Azure perché l'oggetto DnsZone locale è stato recuperato (solo le operazioni direttamente sulla risorsa della zona DNS vengono conteggiate come modifiche, le operazioni sui set di record all'interno della zona non lo fanno). 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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Passthru

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Zone

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

Type:DnsZone
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Input

String

DnsZone

Output

Boolean

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 la conferma prima dell'esecuzione. Se si specifica Confirm:$False, il cmdlet non richiede la conferma.