Dela via


Remove-AzPrivateDnsRecordSet

Tar bort en postuppsättning från en privat DNS-zon.

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

Description

Cmdleten Remove-AzPrivateDnsRecordSet tar bort den angivna postuppsättningen från den angivna zonen. Du kan inte ta bort SOA-poster som skapas automatiskt i den privata zonens topp. Du kan skicka ett RecordSet-objekt till den här cmdleten med hjälp av pipelineoperatorn eller som en parameter eller som ett ResourceId. Om du vill identifiera en post som anges efter namn och typ utan att använda ett RecordSet-objekt måste du skicka zonen som ett PSPrivateDnsZone-objekt till den här cmdleten med hjälp av pipelineoperatorn eller som en parameter, eller alternativt kan du ange parametrarna ZoneName och ResourceGroupName. Du kan använda parametern Confirm och $ConfirmPreference Windows PowerShell för att kontrollera om cmdleten ber dig om bekräftelse. När du anger postuppsättningen med ett RecordSet-objekt tas inte postuppsättningen bort om den har ändrats i Azure Private DNS sedan det lokala RecordSet-objektet hämtades. Detta ger skydd för samtidiga ändringar. Du kan ignorera detta med hjälp av parametern Skriv över, som tar bort postuppsättningen oavsett samtidiga ändringar.

Exempel

Exempel 1: Ta bort en postuppsättning

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

Det första kommandot hämtar den angivna postuppsättningen och lagrar den sedan i variabeln $RecordSet. Det andra kommandot tar bort posten i $RecordSet.

Exempel 2: Ta bort en postuppsättning och ignorera all bekräftelse

$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

Det första kommandot hämtar den angivna postuppsättningen. Det andra kommandot tar bort postuppsättningen, även om den har ändrats under tiden. Bekräftelseprompter ignoreras.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Namnet på posterna i postuppsättningen (i förhållande till namnet på zonen och utan en avslutande punkt).

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Overwrite

Använd inte fältet ETag i parametern RecordSet för optimistiska samtidighetskontroller.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PassThru

Används för att skicka resultatet (booleskt) av åtgärden ta bort den privata zonen längre ned i pipelinen.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RecordSet

Posten som posten ska läggas till i.

Typ:PSPrivateDnsRecordSet
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-RecordType

Typ av privata DNS-poster i postuppsättningen.

Typ:RecordType
Godkända värden:A, AAAA, CNAME, MX, PTR, SOA, SRV, TXT
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ResourceGroupName

Den resursgrupp som zonen tillhör.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ResourceId

Private DNS RecordSet ResourceID.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Zone

PrivateDnsZone-objektet som representerar zonen där postuppsättningen ska skapas.

Typ:PSPrivateDnsZone
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ZoneName

Zonen där postuppsättningen finns (utan en avslutande punkt).

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

PSPrivateDnsZone

PSPrivateDnsRecordSet

String

Utdata

Boolean