共用方式為


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

輸入

PSPrivateDnsZone

PSPrivateDnsRecordSet

String

輸出

Boolean