Dela via


Remove-AzDnsRecordSet

Tar bort en postuppsättning.

Syntax

Remove-AzDnsRecordSet
      -Name <String>
      -RecordType <RecordType>
      -ZoneName <String>
      -ResourceGroupName <String>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzDnsRecordSet
      -Name <String>
      -RecordType <RecordType>
      -Zone <DnsZone>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzDnsRecordSet
      -RecordSet <DnsRecordSet>
      [-Overwrite]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Cmdleten Remove-AzDnsRecordSet tar bort den angivna postuppsättningen från den angivna zonen. Du kan inte ta bort SOA- eller namnserverposter (NS) som skapas automatiskt i zonexet. Du kan skicka ett RecordSet-objekt till den här cmdleten med hjälp av pipelineoperatorn eller som en parameter. Om du vill identifiera en post som angetts efter namn och typ utan att använda ett RecordSet-objekt måste du skicka zonen som ett DnsZone-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 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-AzDnsRecordSet -Name "www" -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordSet -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-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

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:False
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

Anger namnet på den RecordSet som ska tas bort. När du anger posten som angetts efter namn måste DNS-zonen anges med parametrarna Zonparametern eller ZoneName och ResourceGroupName . Du kan också ange postuppsättningen med hjälp av ett RecordSet-objekt som skickas med parametern RecordSet .

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

-Overwrite

När du anger postuppsättningen med ett RecordSet-objekt tas inte postuppsättningen bort om den har ändrats i Azure DNS sedan det lokala RecordSet-objektet hämtades. Detta ger skydd för samtidiga ändringar. Detta kan ignoreras med hjälp av parametern Overwrite , som tar bort postuppsättningen oavsett samtidiga ändringar.

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

-PassThru

passthru

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

-RecordSet

Anger objektet RecordSet som ska tas bort. Du kan också ange postuppsättningen med parametrarna Namn och Zon, eller med parametrarna Namn, ZoneName och ResourceGroupName.

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

-RecordType

Anger typen av DNS-post. Giltiga värden är:

  • A
  • AAAA
  • CNAME
  • MX
  • NS
  • PTR
  • SRV
  • TXT SOA-poster tas bort automatiskt när zonen tas bort. Du kan inte ta bort SOA-poster manuellt.
Typ:RecordType
Godkända värden:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ResourceGroupName

Anger den resursgrupp som innehåller DNS-zonen som innehåller den RecordSet som ska tas bort. Den här parametern gäller endast när postuppsättningen och DNS-zonen anges med parametrarna Namn och ZoneName . Du kan också ange postuppsättningen med parametern RecordSet eller parametrarna Namn och Zon .

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ördes. Cmdleten körs inte.

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

-Zone

Anger den DNS-zon som innehåller den RecordSet som ska tas bort. Den här parametern gäller endast när du anger postuppsättningen med hjälp av parametern Namn . Du kan också ange postuppsättningen med parametern RecordSet eller parametrarna Namn, ZoneName och ResourceGroupName .

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

-ZoneName

Anger namnet på den zon som innehåller den RecordSet som ska tas bort. Du måste också ange parametrarna Namn och ResourceGroupName . Du kan också ange postuppsättningen med parametern RecordSet eller parametrarna Namn och Zon .

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

Indata

RecordType

String

DnsZone

DnsRecordSet

Utdata

Boolean

Kommentarer

Du kan använda parametern Bekräfta för att kontrollera om den här cmdleten uppmanar dig att bekräfta. Som standard uppmanar cmdleten dig att bekräfta om $ConfirmPreference Windows PowerShell-variabeln har värdet Medel eller lägre. Om du anger Bekräfta eller Bekräfta:$True uppmanas du att bekräfta den här cmdleten innan den körs. Om du anger Confirm:$False uppmanas du inte att bekräfta cmdleten.