Set-AzDnsZone

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

DNS ゾーンのプロパティを更新します。

構文

Set-AzDnsZone
   -Name <String>
   -ResourceGroupName <String>
   [-Tag <Hashtable>]
   [-RegistrationVirtualNetworkId <System.Collections.Generic.List`1[System.String]>]
   [-ResolutionVirtualNetworkId <System.Collections.Generic.List`1[System.String]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzDnsZone
   -Name <String>
   -ResourceGroupName <String>
   [-Tag <Hashtable>]
   [-RegistrationVirtualNetwork <System.Collections.Generic.List`1[Microsoft.Azure.Management.Internal.Network.Common.IResourceReference]>]
   [-ResolutionVirtualNetwork <System.Collections.Generic.List`1[Microsoft.Azure.Management.Internal.Network.Common.IResourceReference]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzDnsZone
   -Zone <DnsZone>
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

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

例

例 1: DNS ゾーンを更新する

$Zone = Get-AzDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup"
$Zone.Tags = @(@{"Name"="Dept"; "Value"="Electrical"})
Set-AzDnsZone -Zone $Zone

最初のコマンドは、指定したリソース グループから myzone.com という名前のゾーンを取得し、それを $Zone 変数に格納します。 2 番目のコマンドは、$Zoneのタグを更新します。 最後のコマンドによって変更がコミットされます。

例 2: ゾーンのタグを更新する

Set-AzDnsZone -ResourceGroupName "MyResourceGroup" -Name "myzone.com" -Tag @(@{"Name"="Dept"; "Value"="Electrical"})

このコマンドは、最初に明示的にゾーンを取得せずに、myzone.com という名前のゾーンのタグを更新します。

例 3: ID を指定してプライベート ゾーンを仮想ネットワークに関連付けます

$vnet = Get-AzVirtualNetwork -ResourceGroupName "MyResourceGroup" -Name "myvnet"
Set-AzDnsZone -ResourceGroupName "MyResourceGroup" -Name "myprivatezone.com" -RegistrationVirtualNetworkId @($vnet.Id)

このコマンドは、myprivatezone.com プライベート DNS ゾーンを登録ネットワークとして仮想ネットワーク myvnet に関連付けます。その ID を指定します。

例 4: ネットワーク オブジェクトを指定して、プライベート ゾーンを仮想ネットワークに関連付けます。

$vnet = Get-AzVirtualNetwork -ResourceGroupName "MyResourceGroup" -Name "myvnet"
Set-AzDnsZone -ResourceGroupName "MyResourceGroup" -Name "myprivatezone.com" -RegistrationVirtualNetwork @($vnet)

このコマンドは、プライベート DNS ゾーン myprivatezone.com を登録ネットワークとして仮想ネットワーク myvnet に関連付けます。これは、$vnet変数で表される仮想ネットワーク オブジェクトを Set-AzDnsZone コマンドレットに渡すことによって行います。

パラメーター

-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 ゾーンの名前を指定します。

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

-Overwrite

DNS ゾーンをオブジェクトとして渡すとき (ゾーン オブジェクトを使用するか、パイプラインを介して)、ローカル DnsZone オブジェクトが取得されてから Azure DNS で変更されている場合は更新されません。 これにより、同時変更の保護が提供されます。 この動作は、同時変更に関係なくゾーンを 更新する Overwrite パラメーターを使用して抑制できます。

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

-RegistrationVirtualNetwork

この DNS ゾーンに仮想マシンのホスト名レコードを登録する仮想ネットワークの一覧。プライベート ゾーンでのみ使用できます。

Type:List<T>[IResourceReference]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RegistrationVirtualNetworkId

この DNS ゾーンに仮想マシンのホスト名レコードを登録する仮想ネットワーク ID の一覧。プライベート ゾーンでのみ使用できます。

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResolutionVirtualNetwork

この DNS ゾーン内のレコードを解決できる仮想ネットワークの一覧。プライベート ゾーンでのみ使用できます。

Type:List<T>[IResourceReference]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResolutionVirtualNetworkId

この DNS ゾーン内のレコードを解決できる仮想ネットワーク ID の一覧。プライベート ゾーンでのみ使用できます。

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

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

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

-Tag

ハッシュ テーブルの形式のキーと値のペア。 例: @{key0="value0";key1=$null;key2="value2"}

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

-WhatIf

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

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

-Zone

更新する DNS ゾーンを指定します。 または、ZoneName パラメーターと ResourceGroupName パラメーターを使用してゾーンを指定することもできます。

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

入力

String

Hashtable

List<T>[[System.String, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

List<T>[[Microsoft.Azure.Management.Internal.Network.Common.IResourceReference, Microsoft.Azure.PowerShell.Clients.Network, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

DnsZone

出力

DnsZone

メモ

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