共用方式為

Set-AzDnsRecordSet

  • 參考
模組:
Az.Dns

更新 DNS 記錄集。

語法

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

Description

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 是否提示您進行確認。 根據預設，Cmdlet 會提示您確認$ConfirmPreference Windows PowerShell 變數的值是否為 Medium 或更低。 如果您指定 Confirm 或 Confirm：$True，此 Cmdlet 會在執行之前提示您確認。 如果您指定 Confirm：$False，Cmdlet 不會提示您進行確認。