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,或者您也可以指定 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 之前,提示您進行確認。
類型: | SwitchParameter |
別名: | cf |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶
類型: | IAzureContextContainer |
別名: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Name
指定要移除 RecordSet 的名稱。 依名稱指定記錄集時,必須使用 Zone 參數或 ZoneName 和 ResourceGroupName 參數來指定 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 物件。 或者,您可以使用 Name 和 Zone 參數,或使用 Name、ZoneName和 ResourceGroupName 參數來指定記錄集。
類型: | 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 區域的資源群組。 只有在使用 Name 和 ZoneName 參數來指定記錄集和 DNS 區域時,才適用此參數。 或者,您可以使用 RecordSet 參數或 Name 和 Zone 參數來指定記錄集。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。
類型: | SwitchParameter |
別名: | wi |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Zone
指定要刪除之 RecordSet 的 DNS 區域。 只有在使用 Name 參數指定記錄集時,才適用此參數。 或者,您可以使用 RecordSet 參數或 Name、ZoneName和 ResourceGroupName 參數來指定記錄集。
類型: | DnsZone |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-ZoneName
指定要刪除之 RecordSet 的區域名稱。 您也必須指定 Name 和 ResourceGroupName 參數。 或者,您可以使用 RecordSet 參數或 Name 和 Zone 參數來指定記錄集。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
輸入
輸出
備註
您可以使用 Confirm 參數來控制此 Cmdlet 是否提示您進行確認。 根據預設,Cmdlet 會提示您確認$ConfirmPreference Windows PowerShell 變數的值是否為 Medium 或更低。 如果您指定 Confirm 或 Confirm:$True,此 Cmdlet 會在執行之前提示您確認。 如果您指定 Confirm:$False,Cmdlet 不會提示您進行確認。