次の方法で共有

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)

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

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

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

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

パラメーター

-Confirm

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

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

-DefaultProfile

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

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

-Name

更新する DNS ゾーンの名前を指定します。

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

-Overwrite

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

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

-RegistrationVirtualNetwork

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

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

-RegistrationVirtualNetworkId

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

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

-ResolutionVirtualNetwork

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

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

-ResolutionVirtualNetworkId

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

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

-ResourceGroupName

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

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

-Tag

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

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

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

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

-Zone

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

型:DnsZone
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る: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:$Trueを すると、このコマンドレットを実行する前に確認を求められます。 Confirm:$False指定した場合、コマンドレットは確認を求めるメッセージを表示しません。