Sdílet prostřednictvím

Remove-AzDnsRecordSet

  • Reference
Modul:
Az.Dns

Odstraní sadu záznamů.

Syntaxe

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

Rutina Remove-AzDnsRecordSet odstraní zadanou sadu záznamů ze zadané zóny. Záznamy SOA nebo názvového serveru (NS), které se automaticky vytvářejí na vrcholu zóny, nelze odstranit. Do této rutiny můžete předat objekt RecordSet pomocí operátoru kanálu nebo jako parametru. Pokud chcete identifikovat sadu záznamů podle názvu a typu bez použití objektu RecordSet , musíte tuto zónu předat jako objekt DnsZone této rutině pomocí operátoru kanálu nebo jako parametru nebo případně můžete zadat parametry ZoneName a ResourceGroupName . Pomocí parametru Confirm a $ConfirmPreference proměnné Prostředí Windows PowerShell můžete určit, jestli vás rutina vyzve k potvrzení. Při zadávání sady záznamů pomocí objektu RecordSet se sada záznamů neodstraní, pokud byla změněna v Azure DNS od načtení místního objektu RecordSet . To zajišťuje ochranu souběžných změn. Můžete to potlačit pomocí parametru Overwrite , který odstraní sadu záznamů bez ohledu na souběžné změny.

Příklady

Příklad 1: Odebrání sady záznamů

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

První příkaz získá zadanou sadu záznamů a pak ji uloží do proměnné $RecordSet. Druhý příkaz odebere sadu záznamů v $RecordSet.

Příklad 2: Odebrání sady záznamů a potlačení všech potvrzení

$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

První příkaz získá zadanou sadu záznamů. Druhý příkaz odstraní sadu záznamů, i když se mezitím změnila. Výzvy k potvrzení jsou potlačeny.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Určuje název sady záznamů , která se má odebrat. Při zadávání sady záznamů podle názvu musí být zóna DNS zadána pomocí parametru Zone nebo ZoneName a ResourceGroupName parametrů. Případně lze sadu záznamů zadat pomocí objektu RecordSet předaného pomocí parametru RecordSet.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Overwrite

Při zadávání sady záznamů pomocí objektu RecordSet se sada záznamů neodstraní, pokud byla změněna v Azure DNS od načtení místního objektu RecordSet . To zajišťuje ochranu souběžných změn. To lze potlačit pomocí parametru Přepsání , který odstraní sadu záznamů bez ohledu na souběžné změny.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PassThru

passthru

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RecordSet

Určuje objekt RecordSet , který se má odebrat. Případně můžete sadu záznamů zadat pomocí parametrů Name a Zone nebo pomocí parametrů Name, ZoneName a ResourceGroupName .

Typ:DnsRecordSet
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-RecordType

Určuje typ záznamu DNS. Platné hodnoty jsou:

  • A
  • AAAA
  • CNAME
  • MX
  • NS
  • PTR
  • SRV
  • Záznamy TXT SOA se při odstranění zóny odstraní automaticky. Záznamy SOA nelze odstranit ručně.
Typ:RecordType
Přípustné hodnoty:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ResourceGroupName

Určuje skupinu prostředků, která obsahuje zónu DNS obsahující sadu záznamů, kterou chcete odstranit. Tento parametr je použitelný pouze v případě, že je sada záznamů a zóna DNS zadány pomocí parametrů Name a ZoneName . Sadu záznamů můžete také zadat pomocí parametru RecordSet nebo parametrů Name a Zone.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Zone

Určuje zónu DNS, která obsahuje sadu záznamů , která se má odstranit. Tento parametr lze použít pouze při zadávání sady záznamů pomocí parametru Name . Sadu záznamů můžete také zadat pomocí parametru RecordSet nebo parametrů Name, ZoneName a ResourceGroupName .

Typ:DnsZone
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ZoneName

Určuje název zóny, která obsahuje sadu záznamů , která se má odstranit. Musíte také zadat parametry Name a ResourceGroupName . Sadu záznamů můžete také zadat pomocí parametru RecordSet nebo parametrů Name a Zone.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

RecordType

String

DnsZone

DnsRecordSet

Výstupy

Boolean

Poznámky

Pomocí parametru Confirm můžete určit, jestli vás tato rutina vyzve k potvrzení. Ve výchozím nastavení vás rutina vyzve k potvrzení, pokud má proměnná $ConfirmPreference Prostředí Windows PowerShell hodnotu Střední nebo nižší. Pokud zadáte Potvrdit nebo Potvrdit:$True, zobrazí se tato rutina před spuštěním výzvy k potvrzení. Pokud zadáte Confirm :$False, rutina vás k potvrzení nezobrazí.