Freigeben über

Remove-AzDnsRecordSet

Modul:
Az.Dns Module

Löscht einen Datensatzsatz.

Syntax

Fields 

Remove-AzDnsRecordSet
    -Name <String>
    -RecordType <RecordType>
    -ZoneName <String>
    -ResourceGroupName <String>
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Mixed 

Remove-AzDnsRecordSet
    -Name <String>
    -RecordType <RecordType>
    -Zone <DnsZone>
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Object 

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

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultProfile

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

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Fields
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
Mixed
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Object
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PassThru

Passthru

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:DnsRecordSet
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Object
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:RecordType
Standardwert:None
Zulässige Werte:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Fields
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False
Mixed
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Fields
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-WhatIf

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:DnsZone
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Mixed
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Fields
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

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.