Sdílet prostřednictvím

Remove-AzDnsZone

  • Reference
Modul:
Az.Dns

Odebere zónu DNS ze skupiny prostředků.

Syntaxe

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

Description

Rutina Remove-AzDnsZone trvale odstraní zónu DNS (Domain Name System) ze zadané skupiny prostředků. Odstraní se také všechny sady záznamů obsažené v zóně. Objekt DnsZone můžete předat pomocí parametru Name nebo pomocí operátoru kanálu nebo případně zadat parametry ZoneName a ResourceGroupName. Pomocí parametru Confirm a $ConfirmPreference proměnné Prostředí Windows PowerShell můžete určit, jestli vás rutina vyzve k potvrzení. Při zadávání zóny pomocí objektu DnsZone (předaného prostřednictvím parametru kanálu nebo zóny ) se zóna neodstraní, pokud byla změněna v Azure DNS od načtení místního objektu DnsZone (operace přímo s prostředkem zóny DNS se počítají jako změny, operace se sadami záznamů v rámci zóny ne). To poskytuje ochranu pro souběžné změny zóny. To lze potlačit pomocí parametru Přepsání , který odstraní zónu bez ohledu na souběžné změny.

Příklady

Příklad 1: Odebrání zóny

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

Tento příkaz odebere zónu s názvem myzone.com ze skupiny prostředků MyResourceGroup.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Určuje název zóny DNS, kterou tato rutina odebere. Musíte také zadat parametr ResourceGroupName . Případně můžete zónu DNS zadat pomocí parametru Zone .

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Overwrite

Při zadávání zóny pomocí objektu DnsZone (předaného prostřednictvím parametru kanálu nebo zóny ) se zóna neodstraní, pokud byla změněna v Azure DNS od načtení místního objektu DnsZone (operace přímo s prostředkem zóny DNS se počítají jako změny, operace se sadami záznamů v rámci zóny ne). To poskytuje ochranu pro souběžné změny zóny. To lze potlačit pomocí parametru Přepsání , který odstraní zónu bez ohledu na souběžné změny.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PassThru

passthru

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ResourceGroupName

Určuje název skupiny prostředků, která obsahuje zónu, kterou chcete odebrat. Musíte také zadat parametr ZoneName . Alternativně můžete určit zónu DNS pomocí objektu DnsZone předaného prostřednictvím kanálu nebo parametru Zone .

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Zone

Určuje zónu DNS, která se má odstranit. Předávaný objekt DnsZone lze také předat prostřednictvím kanálu. Případně můžete určit zónu DNS, kterou chcete odstranit, pomocí parametrů ZoneName a ResourceGroupName .

Typ:DnsZone
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

String

DnsZone

Výstupy

Boolean

Poznámky

Vzhledem k potenciálně vysokému dopadu odstranění zóny DNS tato rutina ve výchozím nastavení vyzve k potvrzení, pokud má proměnná $ConfirmPreference Windows PowerShell jinou hodnotu než None. Pokud zadáte Potvrdit nebo Potvrdit:$True, zobrazí se tato rutina před spuštěním výzvy k potvrzení. Pokud zadáte Confirm :$False, rutina vás k potvrzení nezobrazí.