Remove-AzPrivateDnsRecordSet

Löscht einen Datensatzsatz aus einer Privates DNS Zone.

Syntax

Remove-AzPrivateDnsRecordSet
      -ResourceGroupName <String>
      -ZoneName <String>
      -Name <String>
      -RecordType <RecordType>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzPrivateDnsRecordSet
      -Zone <PSPrivateDnsZone>
      -Name <String>
      -RecordType <RecordType>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzPrivateDnsRecordSet
      -RecordSet <PSPrivateDnsRecordSet>
      [-Overwrite]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzPrivateDnsRecordSet
      -ResourceId <String>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Mit dem Cmdlet Remove-AzPrivateDnsRecordSet wird der angegebene Datensatzsatz aus der angegebenen Zone gelöscht. Sie können KEINE SOA-Datensätze löschen, die automatisch in der privaten Zone Apex erstellt werden. Sie können ein RecordSet-Objekt an dieses Cmdlet übergeben, indem Sie den Pipelineoperator oder als Parameter oder als ResourceId verwenden. Um einen Datensatz nach Name und Typ zu identifizieren, ohne ein RecordSet-Objekt zu verwenden, müssen Sie die Zone als PSPrivateDnsZone-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 Privates 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-AzPrivateDnsRecordSet -Name "www" -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzPrivateDnsRecordSet -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-AzPrivateDnsRecordSet -Name "www" -ZoneName "myzone.com" -ResourceGroupName "MyResourceGroup"
Remove-AzPrivateDnsRecordSet -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-AzPrivateDnsRecordSet -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:None
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

Der Name der Datensätze im Datensatzsatz (relativ zum Namen der Zone und ohne endenden Punkt).

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

-Overwrite

Verwenden Sie nicht das ETag-Feld des RecordSet-Parameters für optimistische Parallelitätsprüfungen.

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

-RecordSet

Der Datensatzsatz, in dem der Datensatz hinzugefügt werden soll.

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

-RecordType

Der Typ von Privates DNS Datensätzen im Datensatzsatz.

Typ:RecordType
Zulässige Werte:A, AAAA, CNAME, MX, PTR, SOA, SRV, TXT
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Die Ressourcengruppe, zu der die Zone gehört.

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

-ResourceId

Privates DNS RecordSet ResourceID.

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:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Zone

Das PrivateDnsZone -Objekt, das die Zone darstellt, in der der Datensatzsatz erstellt werden soll.

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

-ZoneName

Die Zone, in der der Datensatzsatz vorhanden ist (ohne einen Endpunkt).

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

Eingaben

PSPrivateDnsZone

PSPrivateDnsRecordSet

String

Ausgaben

Boolean