你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

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>]

说明

Remove-AzPrivateDnsRecordSet cmdlet 从指定区域中删除指定的记录集。 不能删除在专用区域顶点自动创建的 SOA 记录。 可以使用管道运算符或参数或 ResourceId 将 RecordSet 对象传递给此 cmdlet。 若要在不使用 RecordSet 对象的情况下按名称和类型标识记录集,必须使用管道运算符或参数将区域作为 PSPrivateDnsZone 对象传递给此 cmdlet,或者也可以指定 ZoneName 和 ResourceGroupName 参数。 可以使用 Confirm 参数和 $ConfirmPreference Windows PowerShell 变量来控制 cmdlet 是否提示你进行确认。 使用 RecordSet 对象指定记录集时,如果在 Azure 私人 DNS中更改了记录集,则不会删除记录集,因为检索了本地 RecordSet 对象。 这为并发更改提供保护。 可以使用 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 之前进行确认。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
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

记录集中记录的名称(相对于区域的名称和没有终止点)。

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

-Overwrite

不要将 RecordSet 参数的 ETag 字段用于乐观并发检查。

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

-PassThru

用于传递操作的结果(布尔值),删除管道后面的专用区域。

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

-RecordSet

要在其中添加记录的记录集。

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

-RecordType

记录集中私人 DNS记录的类型。

Type:RecordType
Accepted values:A, AAAA, CNAME, MX, PTR, SOA, SRV, TXT
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

区域所属的资源组。

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

-ResourceId

私人 DNS RecordSet ResourceID。

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:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Zone

表示在其中创建记录集的区域的 PrivateDnsZone 对象。

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

-ZoneName

记录集所在的区域(没有终止点)。

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

输入

PSPrivateDnsZone

PSPrivateDnsRecordSet

String

输出

Boolean