Remove-AzPrivateDnsRecordSet
從私人 DNS 區域刪除記錄集。
語法
Remove-AzPrivateDnsRecordSet
-ResourceGroupName <String>
-ZoneName <String>
-Name <String>
-RecordType <RecordType>
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-AzPrivateDnsRecordSet
-Zone <PSPrivateDnsZone>
-Name <String>
-RecordType <RecordType>
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-AzPrivateDnsRecordSet
-RecordSet <PSPrivateDnsRecordSet>
[-Overwrite]
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-AzPrivateDnsRecordSet
-ResourceId <String>
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Remove-AzPrivateDnsRecordSet Cmdlet 會從指定的區域刪除指定的記錄集。 您無法刪除在私人區域頂點自動建立的SOA記錄。 您可以使用管線運算符或參數或 ResourceId,將 RecordSet 對象傳遞至此 Cmdlet。 若要透過名稱和類型來識別記錄集,而不使用 RecordSet 物件,您必須使用管線運算符或參數,將區域當做 PSPrivateDnsZone 對象傳遞至此 Cmdlet,或者您也可以指定 ZoneName 和 ResourceGroupName 參數。 您可以使用 Confirm 參數和 $ConfirmPreference Windows PowerShell 變數來控制 Cmdlet 是否提示您進行確認。 使用 RecordSet 物件指定記錄集時,如果在擷取本機 RecordSet 物件之後已在 Azure Private DNS 中變更記錄集,則不會刪除記錄集。 這會為並行變更提供保護。 您可以使用 Overwrite 參數來隱藏此項目,不論並行變更為何,都會刪除記錄集。
範例
範例 1:移除記錄集
$RecordSet = Get-AzPrivateDnsRecordSet -Name "www" -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzPrivateDnsRecordSet -RecordSet $RecordSet
第一個命令會取得指定的記錄集,然後將它儲存在$RecordSet變數中。第二個命令會移除 $RecordSet 中的記錄集。
範例 2:移除記錄集並隱藏所有確認
$RecordSet = Get-AzPrivateDnsRecordSet -Name "www" -ZoneName "myzone.com" -ResourceGroupName "MyResourceGroup"
Remove-AzPrivateDnsRecordSet -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-AzPrivateDnsRecordSet -Name "www" -ZoneName "myzone.com" -ResourceGroupName "MyResourceGroup" -Confirm:$False
第一個命令會取得指定的記錄集。 第二個命令會刪除記錄集,即使同時變更也一樣。 確認提示會隱藏。
參數
-Confirm
在執行 Cmdlet 之前,提示您進行確認。
類型: | SwitchParameter |
別名: | cf |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DefaultProfile
用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。
類型: | IAzureContextContainer |
別名: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Name
記錄集中的記錄名稱(相對於區域的名稱,不含終止點)。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-Overwrite
請勿使用 RecordSet 參數的 ETag 字段進行開放式並行檢查。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-PassThru
用於傳遞作業的結果(布爾值)會進一步刪除管線下的私人區域。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-RecordSet
要在其中加入記錄的記錄集。
類型: | PSPrivateDnsRecordSet |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-RecordType
記錄集中的私人 DNS 記錄類型。
類型: | RecordType |
接受的值: | A, AAAA, CNAME, MX, PTR, SOA, SRV, TXT |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-ResourceGroupName
區域所屬的資源群組。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-ResourceId
私人 DNS RecordSet ResourceID。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。
類型: | SwitchParameter |
別名: | wi |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Zone
PrivateDnsZone 物件,代表要在其中建立記錄集的區域。
類型: | PSPrivateDnsZone |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-ZoneName
記錄集所在的區域(不含終止點)。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |