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 cmdlet 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 mithilfe des Pipelineoperators oder als Parameter an dieses Cmdlet übergeben. Um einen Datensatzsatz 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 können Sie den ZoneName 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 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 unterdrücken, indem Sie den parameter Overwrite verwenden, 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

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

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:

  • Ein
  • AAAA
  • CNAME
  • MX
  • NAPTR
  • 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 Eintragssatz und die DNS-Zone mit den Parametern Name und ZoneName angegeben werden. Alternativ können Sie den Datensatzsatz entweder mit dem parameter RecordSet oder dem parameter Name und Zone angeben.

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

-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 parameter RecordSet oder dem parameter Name, ZoneNameund 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 parameter RecordSet oder dem parameter Name und Zone angegeben werden.

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

Eingaben

Ausgaben

Hinweise

Sie können den Parameter Confirm verwenden, um zu 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 Bestätigen oder Confirm:$Trueangeben, werden Sie mit diesem Cmdlet vor der Ausführung zur Bestätigung aufgefordert. Wenn Sie Confirm:$Falseangeben, werden Sie vom Cmdlet nicht zur Bestätigung aufgefordert.