共用方式為

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 是否提示您進行確認。 如果記錄集在擷取本機 RecordSet 物件之後已在 Azure DNS 中變更，則不會更新記錄集。 這會為並行變更提供保護。 您可以使用 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

指出不論並行變更為何，都會更新記錄集。 如果在擷取本機 RecordSet 物件之後，已在 Azure DNS 中變更記錄集，則不會更新記錄集。 這會為並行變更提供保護。 若要隱藏此行為，您可以使用 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 不會提示您進行確認。