共用方式為


Remove-AzDnsRecordSet

刪除記錄集。

語法

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

Remove-AzDnsRecordSet Cmdlet 會從指定的區域刪除指定的記錄集。 您無法刪除區域頂點自動建立的 SOA 或名稱伺服器 (NS) 記錄。 您可以使用管線運算符或參數,將 RecordSet 對象傳遞至這個 Cmdlet。 若要使用 RecordSet 物件來識別記錄集的名稱和類型,您必須使用管線運算符或參數,將區域當做 DnsZone 對象傳遞至此 Cmdlet,或者您也可以指定 ZoneNameResourceGroupName 參數。 您可以使用 Confirm 參數和 $ConfirmPreference Windows PowerShell 變數來控制 Cmdlet 是否提示您進行確認。 使用 RecordSet 物件指定記錄集時,如果已在 Azure DNS 中變更記錄集,則不會刪除記錄集,因為已擷取本機 RecordSet 物件。 這會為並行變更提供保護。 您可以使用 Overwrite 參數來隱藏此功能,不論並行變更為何,都會刪除記錄集。

範例

範例 1:移除記錄集

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

第一個命令會取得指定的記錄集,然後將它儲存在$RecordSet變數中。第二個命令會移除 $RecordSet 中的記錄集。

範例 2:移除記錄集並隱藏所有確認

$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

第一個命令會取得指定的記錄集。 第二個命令會刪除記錄集,即使同時變更也一樣。 確認提示會隱藏。

參數

-Confirm

在執行 Cmdlet 之前,提示您進行確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶

類型:IAzureContextContainer
別名:AzContext, AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Name

指定要移除 RecordSet 的名稱。 依名稱指定記錄集時,必須使用 Zone 參數或 ZoneNameResourceGroupName 參數來指定 DNS 區域。 或者,您可以使用 RecordSet 物件來指定記錄集,而該物件是使用 RecordSet 參數傳遞的。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Overwrite

使用 RecordSet 物件指定記錄集時,如果已在 Azure DNS 中變更記錄集,則不會刪除記錄集,因為已擷取本機 RecordSet 物件。 這會為並行變更提供保護。 這可以使用 Overwrite 參數來隱藏,不論並行變更為何,都會刪除記錄集。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-PassThru

passthru

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-RecordSet

指定要移除 RecordSet 物件。 或者,您可以使用 NameZone 參數,或使用 NameZoneNameResourceGroupName 參數來指定記錄集。

類型:DnsRecordSet
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-RecordType

指定 DNS 記錄的類型。 有效值為:

  • 一個
  • AAAA
  • CNAME
  • MX
  • NAPTR
  • NS
  • PTR
  • SRV
  • 刪除區域時,TXT SOA 記錄會自動刪除。 您無法手動刪除 SOA 記錄。
類型:RecordType
接受的值:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-ResourceGroupName

指定包含要刪除 RecordSet DNS 區域的資源群組。 只有在使用 NameZoneName 參數來指定記錄集和 DNS 區域時,才適用此參數。 或者,您可以使用 RecordSet 參數或 NameZone 參數來指定記錄集。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:SwitchParameter
別名:wi
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-Zone

指定要刪除之 RecordSet 的 DNS 區域。 只有在使用 Name 參數指定記錄集時,才適用此參數。 或者,您可以使用 RecordSet 參數或 NameZoneNameResourceGroupName 參數來指定記錄集。

類型:DnsZone
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-ZoneName

指定要刪除之 RecordSet 的區域名稱。 您也必須指定 NameResourceGroupName 參數。 或者,您可以使用 RecordSet 參數或 NameZone 參數來指定記錄集。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

輸入

RecordType

String

DnsZone

DnsRecordSet

輸出

Boolean

備註

您可以使用 Confirm 參數來控制此 Cmdlet 是否提示您進行確認。 根據預設,Cmdlet 會提示您確認$ConfirmPreference Windows PowerShell 變數的值是否為 Medium 或更低。 如果您指定 ConfirmConfirm:$True,此 Cmdlet 會在執行之前提示您確認。 如果您指定 Confirm:$False,Cmdlet 不會提示您進行確認。