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
Ausgaben
Azure PowerShell