次の方法で共有

New-AzDnsZone

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

新しい DNS ゾーンを作成します。

構文

New-AzDnsZone
   -Name <String>
   -ResourceGroupName <String>
   [-ZoneType <ZoneType>]
   [-ParentZoneId <String>]
   [-Tag <Hashtable>]
   [-RegistrationVirtualNetworkId <System.Collections.Generic.List`1[System.String]>]
   [-ResolutionVirtualNetworkId <System.Collections.Generic.List`1[System.String]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDnsZone
   -Name <String>
   -ResourceGroupName <String>
   [-ZoneType <ZoneType>]
   [-ParentZoneName <String>]
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDnsZone
   -Name <String>
   -ResourceGroupName <String>
   [-ZoneType <ZoneType>]
   [-ParentZone <DnsZone>]
   [-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>]

説明

New-AzDnsZone コマンドレットは、指定されたリソース グループに新しいドメイン ネーム システム (DNS) ゾーンを作成します。 Name パラメーターに一意の DNS ゾーン名を指定する必要があります。コマンドレットはエラーを返します。 ゾーンが作成されたら、New-AzDnsRecordSet コマンドレットを使用して、ゾーンにレコード セットを作成します。 Confirm パラメーターと Windows PowerShell 変数$ConfirmPreference使用して、コマンドレットで確認を求めるメッセージを表示するかどうかを制御できます。

例

例 1: DNS ゾーンを作成する

$Zone = New-AzDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup"

このコマンドは、指定したリソース グループに myzone.com という名前の新しい DNS ゾーンを作成し、$Zone変数に格納します。

例 2: 仮想ネットワーク ID を指定してプライベート DNS ゾーンを作成する

$ResVirtualNetworkId = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testresgroup/providers/Microsoft.Network/virtualNetworks/resvnet"
$Zone = New-AzDnsZone -Name "myprivatezone.com" -ResourceGroupName "MyResourceGroup" -ZoneType Private -ResolutionVirtualNetworkId @($ResVirtualNetworkId)

このコマンドは、指定したリソース グループに myprivatezone.com という名前の新しいプライベート DNS ゾーンを作成し、それに関連付けられた解決仮想ネットワーク (ID を指定) し、$Zone変数に格納します。

例 3: 仮想ネットワーク オブジェクトを指定してプライベート DNS ゾーンを作成する

$ResVirtualNetwork = Get-AzVirtualNetwork -Name "resvnet" -ResourceGroupName "testresgroup"
$Zone = New-AzDnsZone -Name "myprivatezone.com" -ResourceGroupName "MyResourceGroup" -ZoneType Private -ResolutionVirtualNetwork @($ResVirtualNetwork)

このコマンドを実行すると、指定したリソース グループに myprivatezone.com という名前の新しいプライベート DNS ゾーンが作成され、解決仮想ネットワーク ($ResVirtualNetwork 変数によって参照されます) が関連付けられ、$Zone変数に格納されます。

例 4: 親ゾーン名を指定して委任を使用して DNS ゾーンを作成する

$Zone = New-AzDnsZone -Name "mychild.zone.com" -ResourceGroupName "MyResourceGroup" -ParentZoneName "zone.com"

このコマンドは、指定したリソース グループに mychild.zone.com という名前の新しい子 DNS ゾーンを作成し、$Zone変数に格納します。 また、子ゾーンと同じサブスクリプションとリソース グループに存在 zone.com という名前の親 DNS ゾーンに委任を追加します。

例 5: 親ゾーン ID を指定して委任を使用して DNS ゾーンを作成する

$Zone = New-AzDnsZone -Name "mychild.zone.com" -ResourceGroupName "MyResourceGroup" -ParentZoneId "/subscriptions/**67e2/resourceGroups/other-rg/providers/Microsoft.Network/dnszones/zone.com"

このコマンドは、指定したリソース グループに mychild.zone.com という名前の新しい子 DNS ゾーンを作成し、$Zone変数に格納します。 また、リソース グループの zone.com という名前の親 DNS ゾーンに委任が追加されます。他の rg が指定したサブスクリプションは、作成された子ゾーンと同じです。

例 6: 親ゾーン オブジェクトを指定して委任を使用して DNS ゾーンを作成する

$PZone = New-AzDnsZone -Name "zone.com" -ResourceGroupName "MyResourceGroup" 
$Zone = New-AzDnsZone -Name "mychild.zone.com" -ResourceGroupName "MyResourceGroup" -ParentZone @($PZone)

このコマンドは、指定したリソース グループに mychild.zone.com という名前の新しい子 DNS ゾーンを作成し、$Zone変数に格納します。 また、ParentZone オブジェクトで渡された zone.com という名前の親 DNS ゾーンに委任を追加します。

パラメーター

-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

-ParentZone

委任を追加する親ゾーンの完全な名前 (終了ドットなし)。

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

-ParentZoneId

委任を追加する親ゾーンのリソース ID (終了ドットなし)。

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

-ParentZoneName

委任を追加する親ゾーンの完全な名前 (終了ドットなし)。

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

ゾーンを作成するリソース グループを指定します。

型: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

-ZoneType

ゾーンの種類 (パブリックまたはプライベート)。 種類のないゾーンまたはパブリックの種類を持つゾーンは、DNS 階層で使用するためにパブリック DNS サービス プレーンで使用できます。 プライベートの種類を持つゾーンは、関連付けられている一連の仮想ネットワークでのみ表示されます (この機能はプレビュー段階です)。 ゾーンに対してこのプロパティを変更することはできません。

型:Nullable<T>[ZoneType]
指定可能な値:Public, Private
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

入力

Nullable<T>[[Microsoft.Azure.Management.Dns.Models.ZoneType, Microsoft.Azure.Management.Dns, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

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]]

出力

メモ

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