通过

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

Set-AzDnsRecordSet

  • 参考
模块:
Az.Dns

更新 DNS 记录集。

语法

Set-AzDnsRecordSet
   -RecordSet <DnsRecordSet>
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Set-AzDnsRecordSet cmdlet 从本地 RecordSet 对象更新 Azure DNS 服务中的记录集。 可以使用管道运算符将 RecordSet 对象作为参数传递。 可以使用 Confirm 参数和 $ConfirmPreference Windows PowerShell 变量来控制 cmdlet 是否提示你进行确认。 如果记录集已在 Azure DNS 中更改，则记录集不会更新，因为检索了本地 RecordSet 对象。 这为并发更改提供保护。 可以使用 Overwrite 参数取消此行为，无论并发更改如何，都会更新记录集。

示例

示例 1：更新记录集

$RecordSet = Get-AzDnsRecordSet -ResourceGroupName MyResourceGroup -ZoneName myzone.com -Name www -RecordType A
Add-AzDnsRecordConfig -RecordSet $RecordSet -Ipv4Address 172.16.0.0
Add-AzDnsRecordConfig -RecordSet $RecordSet -Ipv4Address 172.31.255.255
Set-AzDnsRecordSet -RecordSet $RecordSet

# These cmdlets can also be piped:

Get-AzDnsRecordSet -ResourceGroupName MyResourceGroup -ZoneName myzone.com -Name www -RecordType A | Add-AzDnsRecordConfig -Ipv4Address 172.16.0.0 | Add-AzDnsRecordConfig -Ipv4Address 172.31.255.255 | Set-AzDnsRecordSet

第一个命令使用 Get-AzDnsRecordSet cmdlet 获取指定的记录集，然后将其存储在$RecordSet变量中。 第二个和第三个命令是行外操作，用于向记录集添加两条 A 记录。 最后一个命令使用 Set-AzDnsRecordSet cmdlet 提交更新。

示例 2：更新 SOA 记录

$Zone = Get-AzDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup"
$RecordSet = Get-AzDnsRecordSet -Name "@" -RecordType SOA -Zone $Zone
$RecordSet.Records[0].Email = "admin.myzone.com"
Set-AzDnsRecordSet -RecordSet $RecordSet

第一个命令使用 Get-AzDnsRecordset cmdlet 获取指定的记录集，然后将其存储在$RecordSet变量中。 第二个命令更新$RecordSet中的指定 SOA 记录。 最后一个命令使用 Set-AzDnsRecordSet cmdlet 在$RecordSet中传播更新。

参数

-Confirm

在运行 cmdlet 之前，提示你进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-DefaultProfile

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

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

-Overwrite

指示无论并发更改如何更新记录集。 如果记录集已在 Azure DNS 中更改，则不会更新记录集，因为检索了本地 RecordSet 对象。 这为并发更改提供保护。 若要取消此行为，可以使用 Overwrite 参数，无论并发更改如何，都会更新记录集。

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

-RecordSet

指定要更新的 RecordSet。

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

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

输入

DnsRecordSet

输出

DnsRecordSet

备注

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