New-AzDnsZone

新しい 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 コマンドレットは、指定したリソース グループに新しい Doメイン Name System (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

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

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

-ParentZone

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

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

-ParentZoneId

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

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

-ParentZoneName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
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

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

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

-ZoneType

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

Type:Nullable<T>[ZoneType]
Accepted values:Public, Private
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

入力

String

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

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

メモ

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