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

Remove-AzureRmDnsRecordSet

删除记录集。

重要

由于 Az PowerShell 模块现在已具有 AzureRM PowerShell 模块的所有功能及更多功能,因此我们将于 2024 年 2 月 29 日停用 AzureRM PowerShell 模块。

若要避免服务中断,请更新脚本,在 2024 年 2 月 29 日结束之前将使用 AzureRM PowerShell 模块的脚本更新为使用 Az PowerShell 模块。 若要自动更新脚本,请按照快速入门指南操作。

语法

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,或者也可以指定 ZoneNameResourceGroupName 参数。 可以使用 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
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

用于与 azure 通信的凭据、帐户、租户和订阅

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Name

指定要删除的 RecordSet 的名称。 按名称指定记录集时,必须使用 Zone 参数或 ZoneNameResourceGroupName 参数指定 DNS 区域。 或者,可以使用 RecordSet 对象(使用 RecordSet 参数传递)指定记录集。

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

-Overwrite

使用 RecordSet 对象指定记录集时,如果在 Azure DNS 中更改了记录集,则不会删除记录集,因为检索了本地 RecordSet 对象。 这为并发更改提供了保护。 可以使用 Overwrite 参数取消此操作,无论并发更改如何,都会删除记录集。

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

-PassThru

passthru

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

-RecordSet

指定要删除的 RecordSet 对象。 或者,可以使用 NameZone 参数或使用 NameZoneNameResourceGroupName 参数指定记录集。

Type:DnsRecordSet
Position:Named
Default value:None
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
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

指定包含要删除的 RecordSet 的 DNS 区域的资源组。 此参数仅适用于使用 NameZoneName 参数指定的记录集和 DNS 区域。 或者,可以使用 RecordSet 参数或 NameZone 参数指定记录集。

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

-WhatIf

显示在此 cmdlet 运行的情况下将会发生什么。 此 cmdlet 未运行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-Zone

指定要删除的 RecordSet 的 DNS 区域。 此参数仅在使用 Name 参数指定记录集时适用。 或者,可以使用 RecordSet 参数或 NameZoneNameResourceGroupName 参数指定记录集。

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

-ZoneName

指定要删除的 RecordSet 的区域的名称。 还必须指定 NameResourceGroupName 参数。 或者,可以使用 RecordSet 参数或 NameZone 参数指定记录集。

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

输入

RecordType

String

DnsZone

参数:区域 (ByValue)

DnsRecordSet

参数:RecordSet (ByValue)

输出

Boolean

备注

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