Delen via


Remove-AzPrivateDnsRecordSet

Hiermee verwijdert u een recordset uit een Privé-DNS zone.

Syntaxis

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>]

Description

De cmdlet Remove-AzPrivateDnsRecordSet verwijdert de opgegeven recordset uit de opgegeven zone. U kunt SOA-records die automatisch worden gemaakt in de apex van de privézone niet verwijderen. U kunt een RecordSet-object doorgeven aan deze cmdlet met behulp van de pijplijnoperator of als een parameter of als een ResourceId. Als u een recordset op naam en type wilt identificeren zonder een RecordSet-object te gebruiken, moet u de zone doorgeven als een PSPrivateDnsZone-object aan deze cmdlet met behulp van de pijplijnoperator of als parameter, of u kunt ook de parameters ZoneName en ResourceGroupName opgeven. U kunt de parameter Bevestigen en $ConfirmPreference Windows PowerShell-variabele gebruiken om te bepalen of de cmdlet u om bevestiging vraagt. Wanneer u de recordset opgeeft met behulp van een RecordSet-object, wordt de recordset niet verwijderd als deze is gewijzigd in Azure Privé-DNS sinds het lokale RecordSet-object is opgehaald. Dit biedt beveiliging voor gelijktijdige wijzigingen. U kunt dit onderdrukken met behulp van de parameter Overschrijven, waarmee de recordset wordt verwijderd, ongeacht gelijktijdige wijzigingen.

Voorbeelden

Voorbeeld 1: Een recordset verwijderen

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

Met de eerste opdracht wordt de opgegeven recordset opgeslagen en vervolgens opgeslagen in de $RecordSet variabele. Met de tweede opdracht wordt de recordset in $RecordSet verwijderd.

Voorbeeld 2: Een recordset verwijderen en alle bevestigingen onderdrukken

$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

Met de eerste opdracht wordt de opgegeven recordset ophaalt. Met de tweede opdracht wordt de recordset verwijderd, zelfs als deze in de tussentijd is gewijzigd. Bevestigingsprompts worden onderdrukt.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

De naam van de records in de recordset (ten opzichte van de naam van de zone en zonder afsluitpunt).

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Overwrite

Gebruik het veld ETag van de parameter RecordSet niet voor optimistische gelijktijdigheidscontroles.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PassThru

Wordt gebruikt om het resultaat (Booleaanse waarde) van de bewerking door te geven, verwijdert u de privézone verderop in de pijplijn.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RecordSet

De recordset waarin de record moet worden toegevoegd.

Type:PSPrivateDnsRecordSet
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-RecordType

Het type Privé-DNS records in de recordset.

Type:RecordType
Geaccepteerde waarden:A, AAAA, CNAME, MX, PTR, SOA, SRV, TXT
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceGroupName

De resourcegroep waartoe de zone behoort.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceId

Privé-DNS RecordSet ResourceID.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Zone

Het PrivateDnsZone-object dat de zone vertegenwoordigt waarin de recordset moet worden gemaakt.

Type:PSPrivateDnsZone
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ZoneName

De zone waarin de recordset bestaat (zonder een afsluitpunt).

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

PSPrivateDnsZone

PSPrivateDnsRecordSet

String

Uitvoerwaarden

Boolean