Freigeben über

Remove-AzPrivateDnsZone

  • Referenz
Modul:
Az.PrivateDns

Entfernt eine private DNS-Zone aus einer Ressourcengruppe.

Syntax

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>]

Beschreibung

Das Cmdlet Remove-AzPrivateDnsZone Cmdlet löscht dauerhaft eine private DNS-Zone (Domain Name System) aus einer angegebenen Ressourcengruppe. Alle datensatzsätze, die in der Zone enthalten sind, werden ebenfalls gelöscht. Sie können ein PrivateDnsZone-objekt übergeben, indem Sie den parameter PrivateZone oder den Pipelineoperator verwenden, oder alternativ können Sie den Name und ResourceGroupName Parameter angeben. Sie können den Parameter "Confirm" und $ConfirmPreference Windows PowerShell-Variable verwenden, um zu steuern, ob das Cmdlet Sie zur Bestätigung auffordert. Wenn Sie die Zone mithilfe eines PrivateDnsZone -Objekts angeben (wird über die Pipeline oder Zone Parameter übergeben), wird die Zone nicht gelöscht, wenn sie seit dem lokalen PrivateDnsZone Objekt in Azure DNS geändert wurde (nur Vorgänge direkt bei der DNS-Zonenressourcenanzahl als Änderungen, Vorgänge für Datensatzsätze innerhalb der Zone nicht). Dies bietet Schutz für gleichzeitige Zonenänderungen. Dies kann mithilfe des Overwrite-Parameters unterdrückt werden, der die Zone unabhängig von gleichzeitigen Änderungen löscht.

Beispiele

Beispiel 1: Entfernen einer privaten Zone

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

Mit diesem Befehl wird die Zone namens myzone.com aus der Ressourcengruppe "MyResourceGroup" entfernt.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen der privaten DNS-Zone an, die dieses Cmdlet entfernt. Sie müssen auch den parameter ResourceGroupName angeben. Alternativ können Sie die DNS-Zone mit dem Parameter Zone angeben.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Overwrite

Wenn Sie die Zone mithilfe eines PrivateDnsZone -Objekts angeben (wird über die Pipeline oder Zone Parameter übergeben), wird die Zone nicht gelöscht, wenn sie seit dem lokalen PrivateDnsZone Objekt in Azure DNS geändert wurde (nur Vorgänge direkt bei der DNS-Zonenressourcenanzahl als Änderungen, Vorgänge für Datensatzsätze innerhalb der Zone nicht). Dies bietet Schutz für gleichzeitige Zonenänderungen. Dies kann mithilfe des Overwrite-Parameters unterdrückt werden, der die Zone unabhängig von gleichzeitigen Änderungen löscht.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PassThru

Wird zum Übergeben des Ergebnisses (boolescher Wert) des Vorgangs "Private Zone löschen" weiter unten in der Pipeline verwendet.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PrivateZone

Das zu löschende private Zonenobjekt.

Typ:PSPrivateDnsZone
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Gibt den Namen der Ressourcengruppe an, die die zu entfernende Zone enthält. Sie müssen auch den parameter ZoneName angeben. Alternativ können Sie die DNS-Zone mithilfe eines PrivateDnsZone--Objekts angeben, das entweder über die Pipeline oder den parameter Zone übergeben wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResourceId

Private DNS Zone ResourceID.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

PSPrivateDnsZone

String

Ausgaben

Boolean