Freigeben über

Remove-AzDnsRecordSet

  • Referenz
Modul:
Az.Dns

Löscht einen Datensatzsatz.

Syntax

Remove-AzDnsRecordSet
      -Name <String>
      -RecordType <RecordType>
      -ZoneName <String>
      -ResourceGroupName <String>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzDnsRecordSet
      -Name <String>
      -RecordType <RecordType>
      -Zone <DnsZone>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzDnsRecordSet
      -RecordSet <DnsRecordSet>
      [-Overwrite]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Mit dem Cmdlet Remove-AzDnsRecordSet wird der angegebene Datensatzsatz aus der angegebenen Zone gelöscht. Sie können KEINE SOA- oder NS-Einträge (Name Server) löschen, die automatisch an der Zone apex erstellt werden. Sie können ein RecordSet-Objekt an dieses Cmdlet übergeben, indem Sie den Pipelineoperator oder als Parameter verwenden. Um einen Datensatz nach Name und Typ zu identifizieren, ohne ein RecordSet-Objekt zu verwenden, müssen Sie die Zone als DnsZone-Objekt an dieses Cmdlet übergeben, indem Sie den Pipelineoperator oder als Parameter verwenden oder alternativ die Parameter ZoneName und ResourceGroupName 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 den Datensatzsatz mithilfe eines RecordSet-Objekts angeben, wird der Datensatzsatz nicht gelöscht, wenn er seit dem Abrufen des lokalen RecordSet-Objekts in Azure DNS geändert wurde. Dies bietet Schutz für gleichzeitige Änderungen. Sie können dies mithilfe des Overwrite-Parameters unterdrücken, der den Datensatzsatz unabhängig von gleichzeitigen Änderungen löscht.

Beispiele

Beispiel 1: Entfernen eines Datensatzsatzes

$RecordSet = Get-AzDnsRecordSet -Name "www" -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordSet -RecordSet $RecordSet

Der erste Befehl ruft den angegebenen Datensatzsatz ab und speichert ihn dann in der $RecordSet Variablen. Mit dem zweiten Befehl wird der Datensatzsatz in $RecordSet entfernt.

Beispiel 2: Entfernen eines Datensatzsatzes und Unterdrücken aller Bestätigungen

$RecordSet = Get-AzDnsRecordSet -Name "www" -ZoneName "myzone.com" -ResourceGroupName "MyResourceGroup"
Remove-AzDnsRecordSet -RecordSet $RecordSet -Confirm:$False -Overwrite

# Alternatively, the record set can be removed as follows.  In this case,
# because the record set is specified by name rather than by object, the
# Overwrite parameter is not applicable.

Remove-AzDnsRecordSet -Name "www" -ZoneName "myzone.com" -ResourceGroupName "MyResourceGroup" -Confirm:$False

Der erste Befehl ruft den angegebenen Datensatzsatz ab. Der zweite Befehl löscht den Datensatzsatz, auch wenn er sich in der Zwischenzeit geändert hat. Bestätigungsaufforderungen werden unterdrückt.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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 des zu entfernenden RecordSets an. Wenn Sie den nach Namen festgelegten Eintrag angeben, muss die DNS-Zone entweder mit dem Parameter Zone oder den Parametern ZoneName und ResourceGroupName angegeben werden. Alternativ kann der Datensatzsatz mithilfe eines RecordSet-Objekts angegeben werden, das mithilfe des RecordSet-Parameters übergeben wird.

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

-Overwrite

Wenn Sie den Datensatzsatz mithilfe eines RecordSet-Objekts angeben, wird der Datensatzsatz nicht gelöscht, wenn er seit dem Abrufen des lokalen RecordSet-Objekts in Azure DNS geändert wurde. Dies bietet Schutz für gleichzeitige Änderungen. Dies kann mithilfe des Overwrite-Parameters unterdrückt werden, der den Datensatzsatz unabhängig von gleichzeitigen Änderungen löscht.

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

-PassThru

passthru

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

-RecordSet

Gibt das zu entfernende RecordSet-Objekt an. Alternativ kann der Datensatzsatz mit den Parametern Name und Zone oder mit den Parametern Name, ZoneName und ResourceGroupName angegeben werden.

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

-RecordType

Gibt den Typ des DNS-Eintrags an. Gültige Werte sind:

  • A
  • AAAA
  • CNAME
  • MX
  • NS
  • PTR
  • SRV
  • TXT SOA-Einträge werden automatisch gelöscht, wenn die Zone gelöscht wird. Sie können SOA-Datensätze nicht manuell löschen.
Typ:RecordType
Zulässige Werte:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Gibt die Ressourcengruppe an, die die DNS-Zone enthält, die das zu löschende RecordSet enthält. Dieser Parameter gilt nur, wenn der Datensatzsatz und die DNS-Zone mit den Parametern Name und ZoneName angegeben werden. Alternativ können Sie den Datensatzsatz entweder mit dem RecordSet-Parameter oder den Parametern Name und Zone angeben.

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

-WhatIf

Zeigt, was geschieht, 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

-Zone

Gibt die DNS-Zone an, die das zu löschende RecordSet enthält. Dieser Parameter gilt nur, wenn der Datensatzsatz mit dem Parameter Name angegeben wird. Alternativ können Sie den Datensatzsatz entweder mit dem RecordSet-Parameter oder den Parametern Name, ZoneName und ResourceGroupName angeben.

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

-ZoneName

Gibt den Namen der Zone an, die das zu löschende RecordSet enthält. Sie müssen auch die Parameter Name und ResourceGroupName angeben. Alternativ kann der Datensatzsatz entweder mit dem RecordSet-Parameter oder den Parametern Name und Zone angegeben werden.

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

Eingaben

RecordType

String

DnsZone

DnsRecordSet

Ausgaben

Boolean

Hinweise

Mit dem Parameter "Confirm" können Sie steuern, ob dieses Cmdlet Sie zur Bestätigung auffordert. Standardmäßig werden Sie vom Cmdlet zur Bestätigung aufgefordert, wenn die $ConfirmPreference Windows PowerShell-Variable den Wert "Mittel" oder "niedriger" aufweist. Wenn Sie "Confirm" oder "Confirm:$True" angeben, werden Sie mit diesem Cmdlet vor der Ausführung zur Bestätigung aufgefordert. Wenn Sie "Confirm:$False" angeben, werden Sie vom Cmdlet nicht zur Bestätigung aufgefordert.