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

Remove-AzDnsRecordConfig

模块:

Az.Dns

从本地记录集对象中删除 DNS 记录。

语法

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Ipv4Address <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Ipv6Address <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Nsdname <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Exchange <String>
      -Preference <UInt16>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Ptrdname <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Value <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Priority <UInt16>
      -Target <String>
      -Port <UInt16>
      -Weight <UInt16>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Cname <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -CaaFlags <Byte>
      -CaaTag <String>
      -CaaValue <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -KeyTag <Int32>
      -Algorithm <Int32>
      -DigestType <Int32>
      -Digest <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Usage <Int32>
      -Selector <Int32>
      -MatchingType <Int32>
      -CertificateAssociationData <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Order <UInt16>
      -Preference <UInt16>
      -Flags <String>
      -Services <String>
      -Regexp <String>
      -Replacement <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

说明

Remove-AzDnsRecordConfig cmdlet 从记录集中删除域名系统（DNS）记录。 RecordSet 对象是一个脱机对象，在运行 Set-AzDnsRecordSet cmdlet 以将更改保存到 Microsoft Azure DNS 服务之前，更改不会更改 DNS 响应。 若要删除记录，该记录类型的所有字段必须完全匹配。 不能添加或删除 SOA 记录。 创建 DNS 区域时会自动创建 SOA 记录，并在删除 DNS 区域时自动删除。 可以将 RecordSet 对象作为参数或管道运算符传递给此 cmdlet。

示例

示例 1：从记录集中删除 A 记录

$RecordSet = Get-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -RecordSet $RecordSet -Ipv4Address 1.2.3.4
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Ipv4Address 1.2.3.4 | Set-AzDnsRecordSet

此示例从现有记录集中删除 A 记录。 如果这是记录集中的唯一记录，则结果将为空记录集。 若要完全删除记录集，请参阅 Remove-AzDnsRecordSet。

示例 2：从记录集中删除 AAAA 记录

$RecordSet = Get-AzDnsRecordSet -Name "www" -RecordType AAAA -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -RecordSet $RecordSet -Ipv6Address 2001:DB80:4009:1803::1005
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "www" -RecordType AAAA -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Ipv6Address 2001:DB80:4009:1803::1005 | Set-AzDnsRecordSet

此示例从现有记录集中删除 AAAA 记录。 如果这是记录集中的唯一记录，则结果将为空记录集。 若要完全删除记录集，请参阅 Remove-AzDnsRecordSet。

示例 3：从记录集中删除 CNAME 记录

$RecordSet = Get-AzDnsRecordSet -Name "www" -RecordType CNAME -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -RecordSet $RecordSet -Cname contoso.com
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "www" -RecordType CNAME -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Cname contoso.com | Set-AzDnsRecordSet

此示例从现有记录集中删除 CNAME 记录。 由于 CNAME 记录集最多可以包含一条记录，因此结果为空记录集。

示例 4：从记录集中删除 MX 记录

$RecordSet = Get-AzDnsRecordSet -Name "@" -RecordType MX -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -Exchange mail.microsoft.com -Preference 5 -RecordSet $RecordSet
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "@" -RecordType MX -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Exchange mail.microsoft.com -Preference 5 | Set-AzDnsRecordSet

此示例从现有记录集中删除 MX 记录。 记录名称“@”指示区域顶点处的记录集。 如果这是记录集中的唯一记录，则结果为空记录集。 若要完全删除记录集，请参阅 Remove-AzDnsRecordSet。

示例 5：从记录集中删除 NS 记录

$RecordSet = Get-AzDnsRecordSet -Name "abc" -RecordType NS -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -Nsdname ns1.myzone.com -RecordSet $RecordSet
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "abc" -RecordType NS -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Nsdname "ns1.myzone.com" | Set-AzDnsRecordSet

此示例从现有记录集中删除 NS 记录。 如果这是记录集中的唯一记录，则结果为空记录集。 若要完全删除记录集，请参阅 Remove-AzDnsRecordSet。

示例 6：从记录集中删除 PTR 记录

$RecordSet = Get-AzDnsRecordSet -Name "4" -RecordType PTR -ResourceGroupName "MyResourceGroup" -ZoneName 3.2.1.in-addr.arpa
Remove-AzDnsRecordConfig -Ptrdname www.contoso.com -RecordSet $RecordSet
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "4" -RecordType PTR -ResourceGroupName "MyResourceGroup" -ZoneName "3.2.1.in-addr.arpa" | Remove-AzDnsRecordConfig -Ptrdname www.contoso.com | Set-AzDnsRecordSet

此示例从现有记录集中删除 PTR 记录。 如果这是记录集中的唯一记录，则结果为空记录集。 若要完全删除记录集，请参阅 Remove-AzDnsRecordSet。

示例 7：从记录集中删除 SRV 记录

$RecordSet = Get-AzDnsRecordSet -Name "_sip._tcp" -RecordType SRV -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -RecordSet $RecordSet -Priority 0 -Weight 5 -Port 8080 -Target target.example.com
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "_sip._tcp" -RecordType SRV -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Priority 0 -Weight 5 -Port 8080 -Target target.example.com  | Set-AzDnsRecordSet

此示例从现有记录集中删除 SRV 记录。 如果这是记录集中的唯一记录，则结果为空记录集。 若要完全删除记录集，请参阅 Remove-AzDnsRecordSet。

示例 8：从记录集中删除 TXT 记录

$RecordSet = Get-AzDnsRecordSet -Name "text" -RecordType TXT -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -RecordSet $RecordSet -Value "This is a TXT Record"
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "text" -RecordType TXT -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Value "This is a TXT Record"  | Set-AzDnsRecordSet

此示例从现有记录集中删除 TXT 记录。 如果这是记录集中的唯一记录，则结果为空记录集。 若要完全删除记录集，请参阅 Remove-AzDnsRecordSet。

示例 9：从记录集中删除 DS 记录

$RecordSet = Get-AzDnsRecordSet -Name "www" -RecordType DS -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -KeyTag 12345 -Algorithm 3 -DigestType 1 -Digest "49FD46E6C4B45C55D4AC"
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "www" -RecordType DS -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -KeyTag 12345 -Algorithm 3 -DigestType 1 -Digest "49FD46E6C4B45C55D4AC"  | Set-AzDnsRecordSet

此示例从现有记录集中删除 DS 记录。 如果这是记录集中的唯一记录，则结果为空记录集。 若要完全删除记录集，请参阅 Remove-AzDnsRecordSet。

示例 10：从记录集中删除 TLSA 记录

$RecordSet = Get-AzDnsRecordSet -Name "_443._tcp.www" -RecordType TLSA -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -Usage 3 -Selector 1 -MatchingType 1 -CertificateAssociationData "49FD46E6C4B45C55D4AC"
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "_443._tcp.www" -RecordType TLSA -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Usage 3 -Selector 1 -MatchingType 1 -CertificateAssociationData "49FD46E6C4B45C55D4AC"  | Set-AzDnsRecordSet

此示例从现有记录集中删除 TLSA 记录。 如果这是记录集中的唯一记录，则结果为空记录集。 若要完全删除记录集，请参阅 Remove-AzDnsRecordSet。

示例 11：从记录集中删除 NAPTR 记录

$RecordSet = Get-AzDnsRecordSet -Name "www" -RecordType NAPTR -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -Order 100 -Preference 100 -Flags "s" -Services "http" -Regexp "" -Replacement "www.contoso.com"
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "www" -RecordType NAPTR -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Order 100 -Preference 100 -Flags "s" -Services "http" -Regexp "" -Replacement "www.contoso.com"  | Set-AzDnsRecordSet

参数

-Algorithm

要删除的 DS 记录的算法字段。

类型:	Int32
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-CaaFlags

要添加的 CAA 记录的标志。 必须是介于 0 和 255 之间的数字。

类型:	Byte
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-CaaTag

要添加的 CAA 记录的标记字段。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-CaaValue

要添加的 CAA 记录的值字段。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-CertificateAssociationData

要删除的 TLSA 记录的证书关联数据字段。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Cname

指定规范名称 （CNAME） 记录的域名。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-DefaultProfile

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

类型:	IAzureContextContainer
别名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Digest

要删除的 DS 记录的摘要字段。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-DigestType

要删除的 DS 记录的摘要类型字段。

类型:	Int32
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Exchange

指定邮件交换（MX）记录的邮件交换服务器名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Ipv4Address

指定 A 记录的 IPv4 地址。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Ipv6Address

指定 AAAA 记录的 IPv6 地址。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-KeyTag

要删除的 DS 记录的键标记字段。

类型:	Int32
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-MatchingType

要删除的 TLSA 记录的匹配类型字段。

类型:	Int32
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Nsdname

指定名称服务器 （NS） 记录的名称服务器。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Order

指定命名颁发机构指针 （NAPTR） 记录的顺序。

类型:	UInt16
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Port

指定服务（SRV）记录的端口。

类型:	UInt16
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Preference

指定 MX/NAPTR 记录的首选项。

类型:	UInt16
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Priority

指定 SRV 记录的优先级。

类型:	UInt16
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Ptrdname

指定指针（PTR）记录的目标域名。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-RecordSet

指定要删除的记录的 RecordSet 对象。

类型:	DnsRecordSet
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Regexp

指定命名颁发机构指针 （NAPTR） 记录的正则表达式。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Replacement

指定命名颁发机构指针（NAPTR）记录的替换项。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Selector

要删除的 TLSA 记录的选择器字段。

类型:	Int32
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Services

指定命名颁发机构指针 （NAPTR） 记录的服务。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Target

指定 SRV 记录的目标。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Usage

要删除的 TLSA 记录的使用字段。

类型:	Int32
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Value

指定 TXT 记录的值。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Weight

指定 SRV 记录的权重。

类型:	UInt16
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

输入

DnsRecordSet

String

UInt16

Byte

输出

DnsRecordSet

相关链接

• Add-AzDnsRecordConfig
• Get-AzDnsRecordSet
• Set-AzDnsRecordSet