Remove-AzDnsRecordSet

  • 參考
模組:
Az.Dns

刪除記錄集。

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

Remove-AzDnsRecordSet Cmdlet 會從指定的區域刪除指定的記錄集。 您無法刪除區域頂點自動建立的 SOA 或名稱伺服器 （NS） 記錄。 您可以使用管線運算符或參數，將 RecordSet 對象傳遞至這個 Cmdlet。 若要使用 Name 和 type 來識別記錄集，而不使用 RecordSet 物件，您必須使用管線運算符或參數，將區域當做 DnsZone 對象傳遞至此 Cmdlet，或者您也可以指定 ZoneName 和 ResourceGroupName 參數。 您可以使用 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 之前先提示您確認。

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

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

指定要移除的 RecordSet 名稱。 依名稱指定記錄集時，必須使用 Zone 參數或 ZoneName 和 ResourceGroupName 參數來指定 DNS 區域。 或者，您可以使用 RecordSet 物件來指定記錄集，並使用 RecordSet 參數傳遞。

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

-Overwrite

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

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

指定要移除的 RecordSet 物件。 或者，您可以使用 Name 和 Zone 參數，或使用 Name、ZoneName 和 ResourceGroupName 參數來指定記錄集。

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

-RecordType

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

  • A
  • AAAA
  • CNAME
  • MX
  • NS
  • PTR
  • SRV
  • 刪除區域時，TXT SOA 記錄會自動刪除。 您無法手動刪除 SOA 記錄。
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

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

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

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

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

-Zone

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

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

-ZoneName

指定要刪除之 RecordSet 的區域名稱。 您也必須指定 Name 和 ResourceGroupName 參數。 或者，您可以使用 RecordSet 參數或 Name 和 Zone 參數來指定記錄集。

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

輸入

RecordType

String

DnsZone

DnsRecordSet

輸出

Boolean

備註

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