Dela via

Remove-AzDnsRecordSet

  • Referens
Modul:
Az.Dns

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 hjälp av 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 förhindra detta med hjälp av parametern Overwrite, 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å RecordSet att ta bort. När du anger posten som angetts efter namn måste DNS-zonen anges med parametern Zone eller parametrarna 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 hjälp av 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 RecordSet objekt som ska tas bort. Du kan också ange postuppsättningen med parametrarna Name och Zone eller med parametrarna Name, ZoneNameoch 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
  • NAPTR
  • 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 RecordSet att ta bort. Den här parametern gäller endast när postuppsättningen och DNS-zonen anges med parametrarna Name och ZoneName. Du kan också ange postuppsättningen med parametern RecordSet eller parametrarna Name och Zone.

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:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Zone

Anger den DNS-zon som innehåller RecordSet att ta bort. Den här parametern gäller endast när du anger postuppsättningen med parametern Name. Du kan också ange postuppsättningen med parametern RecordSet eller parametrarna Name, ZoneNameoch 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 RecordSet att ta bort. Du måste också ange parametrarna Name och ResourceGroupName. Du kan också ange postuppsättningen med parametern RecordSet eller parametrarna Name och Zone.

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 Confirm för att kontrollera om den här cmdleten ber dig om bekräftelse. 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 Confirm:$Trueuppmanas du att bekräfta den här cmdleten innan den körs. Om du anger Confirm:$Falseuppmanas du inte att bekräfta cmdleten.