Share via

Set-AzPrivateDnsZone

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

リソース グループからプライベート DNS ゾーンを更新します。

構文

Set-AzPrivateDnsZone
   -ResourceGroupName <String>
   -Name <String>
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzPrivateDnsZone
   -ResourceId <String>
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzPrivateDnsZone
   -PrivateZone <PSPrivateDnsZone>
   [-Tag <Hashtable>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Set-AzPrivateDnsZone コマンドレットは、指定されたリソース グループからプライベート Doメイン ネーム システム (DNS) ゾーンを完全に更新します。 PrivateZone パラメーターを使用するか、パイプライン演算子を使用して PrivateDnsZone オブジェクトを渡すか、または Name パラメーターと ResourceGroupName パラメーターを指定することもできます。 Confirm パラメーターと Windows PowerShell 変数$ConfirmPreference使用して、コマンドレットで確認を求めるメッセージを表示するかどうかを制御できます。 PrivateDnsZone オブジェクト (パイプラインまたはゾーン パラメーターを使用して渡される) を使用してゾーンを指定する場合、ローカル PrivateDnsZone オブジェクトが取得されてから Azure DNS で変更された場合、ゾーンは更新されません (DNS ゾーン リソースに対する直接の操作のみが変更としてカウントされ、ゾーン内のレコード セットに対する操作は更新されません)。 これにより、同時ゾーンの変更に対する保護が提供されます。 これは、同時変更に関係なくゾーンを 更新する Overwrite パラメーターを使用して抑制できます。

例

例 1: プライベート ゾーンを更新する

Set-AzPrivateDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup" -Tag @{tag1="value1";tag2="value2"}

Name                          : myzone.com
ResourceId                    : "/subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/PrivateZones/myzone.com"
ResourceGroupName             : MyResourceGroup
Location					  : 
Etag                          : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Tags                          : {tag1="value1";tag2="value2"}
NumberOfRecordSets            : 1
MaxNumberOfRecordSets         : 5000

このコマンドは、MyResourceGroup という名前のリソース グループから myzone.com という名前のゾーンを指定されたタグで更新します。 Get-AzPrivateDnsZone を使用して、更新されたゾーンを取得します。

パラメーター

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
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

-Name

このコマンドレットが更新するプライベート DNS ゾーンの名前を指定します。 ResourceGroupName パラメーターも指定する必要があります。 または、Zone パラメーターを使用してプライベート DNS ゾーンを指定することもできます。

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

-Overwrite

PrivateDnsZone オブジェクト (パイプラインまたはゾーン パラメーターを使用して渡される) を使用してゾーンを指定する場合、ローカル DnsZone オブジェクトが取得されてから Azure DNS で変更された場合、ゾーンは更新されません (DNS ゾーン リソースに対する直接の操作のみが変更としてカウントされ、ゾーン内のレコード セットに対する操作は更新されません)。 これにより、同時ゾーンの変更に対する保護が提供されます。 これは、同時変更に関係なくゾーンを 更新する Overwrite パラメーターを使用して抑制できます。

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

-PrivateZone

設定するゾーン オブジェクト。

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

-ResourceGroupName

更新するゾーンを含むリソース グループの名前を指定します。 ZoneName パラメーターも指定する必要があります。 または、パイプラインまたは Zone パラメーターを使用して渡される DnsZone オブジェクトを使用してプライベート DNS ゾーンを指定することもできます。

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

-ResourceId

プライベート DNS ゾーン リソース ID。

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

-Tag

リソース タグを表すハッシュ テーブル。

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

-WhatIf

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

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

入力

String

PSPrivateDnsZone

出力

PSPrivateDnsZone