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

Remove-AzureRmDnsRecordSet

模块:

AzureRM.Dns

删除记录集。

警告

截至 2024 年 2 月 29 日，AzureRM PowerShell 模块已正式弃用。 为了确保持续获得支持和更新，建议用户从 AzureRM 迁移到 Az PowerShell 模块。

尽管 AzureRM 模块仍可能正常运行，但它不再维护或受支持，但会根据用户的自由裁量权和风险继续使用任何继续使用模块。 有关过渡到 Az 模块的指导，请参阅我们的迁移资源。

语法

Remove-AzureRmDnsRecordSet
      -Name <String>
      -RecordType <RecordType>
      -ZoneName <String>
      -ResourceGroupName <String>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-AzureRmDnsRecordSet
      -Name <String>
      -RecordType <RecordType>
      -Zone <DnsZone>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-AzureRmDnsRecordSet
      -RecordSet <DnsRecordSet>
      [-Overwrite]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

Remove-AzureRmDnsRecordSet cmdlet 从指定区域删除指定的记录集。 不能删除在区域顶点自动创建的 SOA 或名称服务器 （NS） 记录。 可以使用管道运算符或参数将 RecordSet 对象传递给此 cmdlet。 若要使用 RecordSet 对象按名称和类型标识记录集，必须使用管道运算符或参数将区域作为 DnsZone 对象传递给此 cmdlet，或者也可以指定 ZoneName 和 ResourceGroupName 参数。 可以使用 Confirm 参数和 $ConfirmPreference Windows PowerShell 变量来控制 cmdlet 是否提示你进行确认。 使用 RecordSet 对象指定记录集时，如果在 Azure DNS 中更改了记录集，则不会删除记录集，因为检索了本地 RecordSet 对象。 这为并发更改提供保护。 可以使用 Overwrite 参数取消此操作，无论并发更改如何，都会删除记录集。

示例

示例 1：删除记录集

PS C:\> $RecordSet = Get-AzureRmDnsRecordSet -Name "www" -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
PS C:\> Remove-AzureRmDnsRecordSet -RecordSet $RecordSet

第一个命令获取指定的记录集，然后将其存储在$RecordSet变量中。第二个命令删除$RecordSet中的记录集。

示例 2：删除记录集并取消所有确认

PS C:\> $RecordSet = Get-AzureRmDnsRecordSet -Name "www" -ZoneName "myzone.com" -ResourceGroupName "MyResourceGroup"
PS C:\> Remove-AzureRmDnsRecordSet -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.

PS C:\> Remove-AzureRmDnsRecordSet -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:	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
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

参数：区域（ByValue）

DnsRecordSet

参数：RecordSet （ByValue）

输出

Boolean

备注

可以使用 Confirm 参数来控制此 cmdlet 是否提示你进行确认。 默认情况下，如果 $ConfirmPreference Windows PowerShell 变量的值为“中”或“较低”，cmdlet 会提示你进行确认。 如果指定“确认”或“确认：$True”，则此 cmdlet 会在运行之前提示你进行确认。 如果指定 Confirm：$False，cmdlet 不会提示你进行确认。

相关链接

• Get-AzureRmDnsRecordSet
• New-AzureRmDnsRecordSet
• Set-AzureRmDnsRecordSet