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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

passthru

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:DnsRecordSet
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.
Type:RecordType
Accepted values:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 .

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:DnsZone
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 .

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.