Set-AzDnsRecordSet

  • リファレンス
モジュール:
Az.Dns

DNS レコード セットを更新します。

構文

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

説明

Set-AzDnsRecordSet コマンドレットは、ローカル RecordSet オブジェクトから Azure DNS サービスのレコード セットを更新します。 パラメーターとして、またはパイプライン演算子を使用して、 RecordSet オブジェクトを渡すことができます。 Confirm パラメーターと Windows PowerShell 変数$ConfirmPreference使用して、コマンドレットで確認を求めるメッセージを表示するかどうかを制御できます。 レコード セットは、ローカル 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 コマンドレットを使用して指定したレコード セットを取得し、$RecordSet変数に格納します。 2 番目と 3 番目のコマンドは、レコード セットに 2 つの A レコードを追加するオフライン操作です。 最後のコマンドでは、 Set-AzDnsRecordSet コマンドレットを使用して更新プログラムをコミットします。

例 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 コマンドレットを使用して指定したレコード セットを取得し、$RecordSet変数に格納します。 2 番目のコマンドは、$RecordSetで指定された SOA レコードを更新します。 最後のコマンドでは、 Set-AzDnsRecordSet コマンドレットを使用して、更新プログラムを$RecordSetに伝達します。

パラメーター

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション

型:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Overwrite

同時変更に関係なく、レコード セットを更新することを示します。 レコード セットは、ローカル RecordSet オブジェクトが取得されてから Azure DNS で変更された場合は更新されません。 これにより、同時変更の保護が提供されます。 この動作を抑制するには、 Overwrite パラメーターを使用すると、同時変更に関係なくレコード セットが更新されます。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RecordSet

更新する RecordSet を指定します。

型:DnsRecordSet
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 コマンドレットは実行されません。コマンドレットを実行した場合の動作を示します。 このコマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

DnsRecordSet

出力

DnsRecordSet

メモ

Confirm パラメーターを使用して、このコマンドレットで確認を求めるメッセージを表示するかどうかを制御できます。 既定では、$ConfirmPreference Windows PowerShell 変数の値が Medium 以下の場合は、確認を求めるメッセージが表示されます。 Confirm または Confirm:$True を指定すると、このコマンドレットを実行する前に確認を求められます。 Confirm:$False を指定した場合、コマンドレットは確認を求めません。