Share via

Set-AzPrivateDnsRecordSet

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

更新/プライベート DNS ゾーン内のレコード セットを設定します。

構文

Set-AzPrivateDnsRecordSet
   -RecordSet <PSPrivateDnsRecordSet>
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Set-AzPrivateDnsRecordSet コマンドレットは、ローカル RecordSet オブジェクトから Azure プライベート DNS サービスのレコード セットを更新します。 パラメーターとして、またはパイプライン演算子を使用して、RecordSet オブジェクトを渡すことができます。 Confirm パラメーターと Windows PowerShell 変数$ConfirmPreference使用して、コマンドレットで確認を求めるメッセージを表示するかどうかを制御できます。 ローカル RecordSet オブジェクトが取得されてから Azure プライベート DNS でレコード セットが変更された場合、レコード セットは更新されません。 これにより、同時変更の保護が提供されます。 この動作は、レコード セットを同時変更に関係なく更新する Overwrite パラメーターを使用して抑制できます。

例

例 1: レコード セットを更新する

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

# These cmdlets can also be piped:

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

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/providers/Microsoft.Netwo
                    rk/privateDnsZones/myzone.com/A/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {1.2.3.4, 172.16.0.0, 172.31.255.255}
Metadata          :
IsAutoRegistered  :

最初のコマンドでは、Get-AzPrivateDnsRecordSet コマンドレットを使用して指定したレコード セットを取得し、$RecordSet変数に格納します。 2 番目と 3 番目のコマンドは、レコード セットに 2 つの A レコードを追加するオフライン操作です。 最後のコマンドでは、Set-AzPrivateDnsRecordSet コマンドレットを使用して更新プログラムをコミットします。

例 2: SOA レコードを更新する

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

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/SOA/@
Name              : @
ZoneName          : myzone.com
ResourceGroupName : Myresourcegroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : SOA
Records           : {[internal.cloudapp.net,admin.myzone.com,3600,300,2419200,300]}
Metadata          :
IsAutoRegistered  :

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

パラメーター

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Overwrite

オプティミスティック コンカレンシーのチェックには、RecordSet パラメーターの ETag フィールドを使用しないでください。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RecordSet

レコードを追加するレコード セット。

Type:PSPrivateDnsRecordSet
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

PSPrivateDnsRecordSet

出力

PSPrivateDnsRecordSet