Remove-AzDnsRecordSet

Tar bort en postuppsättning.

Syntax

Fields

Remove-AzDnsRecordSet
    -Name <String>
    -RecordType <RecordType>
    -ZoneName <String>
    -ResourceGroupName <String>
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Mixed

Remove-AzDnsRecordSet
    -Name <String>
    -RecordType <RecordType>
    -Zone <DnsZone>
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Object

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 objektet RecordSet 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.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DefaultProfile

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

Parameteregenskaper

Typ:IAzureContextContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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 .

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

Fields
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
Mixed
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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 objektet RecordSet 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.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

Object
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-PassThru

passthru

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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 .

Parameteregenskaper

Typ:DnsRecordSet
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

Object
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:RecordType
Standardvärde:None
Godkända värden:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

Fields
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
Mixed
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument: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 .

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

Fields
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-WhatIf

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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 .

Parameteregenskaper

Typ:DnsZone
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

Mixed
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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 .

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

Fields
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

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.