Dela via

Remove-AzDnsZone

  • Referens
Modul:
Az.Dns

Tar bort en DNS-zon från en resursgrupp.

Syntax

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

Description

Cmdleten Remove-AzDnsZone tar permanent bort en DNS-zon (Domain Name System) från en angiven resursgrupp. Alla postuppsättningar som finns i zonen tas också bort. Du kan skicka ett DnsZone-objekt med parametern Name eller med hjälp av pipelineoperatorn, eller så kan du ange parametrarna ZoneName och ResourceGroupName. Du kan använda parametern Confirm och $ConfirmPreference Windows PowerShell för att kontrollera om cmdleten ber dig om bekräftelse. När du anger zonen med hjälp av ett DnsZone- -objekt (skickas via pipelinen eller zone parameter) tas inte zonen bort om den har ändrats i Azure DNS eftersom det lokala DnsZone--objektet hämtades (endast åtgärder direkt på DNS-zonens resursantal som ändringar, åtgärder på postuppsättningar i zonen inte). Detta ger skydd för samtidiga zonändringar. Detta kan ignoreras med hjälp av parametern Overwrite, som tar bort zonen oavsett samtidiga ändringar.

Exempel

Exempel 1: Ta bort en zon

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

Det här kommandot tar bort zonen med namnet myzone.com från resursgruppen med namnet MyResourceGroup.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Anger namnet på DNS-zonen som den här cmdleten tar bort. Du måste också ange parametern ResourceGroupName. Du kan också ange DNS-zonen med parametern Zone.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Overwrite

När du anger zonen med hjälp av ett DnsZone- -objekt (skickas via pipelinen eller zone parameter) tas inte zonen bort om den har ändrats i Azure DNS eftersom det lokala DnsZone--objektet hämtades (endast åtgärder direkt på DNS-zonens resursantal som ändringar, åtgärder på postuppsättningar i zonen inte). Detta ger skydd för samtidiga zonändringar. Detta kan ignoreras med hjälp av parametern Overwrite, som tar bort zonen oavsett samtidiga ändringar.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PassThru

passthru

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ResourceGroupName

Anger namnet på resursgruppen som innehåller den zon som ska tas bort. Du måste också ange parametern ZoneName. Du kan också ange DNS-zonen med hjälp av ett DnsZone- objekt som skickas via antingen pipelinen eller parametern Zone.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Zone

Anger dns-zonen som ska tas bort. Det DnsZone- objekt som skickas kan också skickas via pipelinen. Du kan också ange dns-zonen som ska tas bort med hjälp av parametrarna ZoneName och ResourceGroupName.

Typ:DnsZone
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Indata

Utdata

Kommentarer

På grund av den potentiellt höga effekten av att ta bort en DNS-zon uppmanas den här cmdleten som standard att bekräfta om $ConfirmPreference Windows PowerShell-variabeln har något annat värde än Inget. Om du anger Bekräfta eller Confirm:$Trueuppmanas du att bekräfta den här cmdleten innan den körs. Om du anger Confirm:$Falseuppmanas du inte att bekräfta cmdleten.