New-AzPrivateDnsRecordSet

リファレンス

モジュール:: Az.PrivateDns

プライベート DNS ゾーンにレコードセットを作成します。

構文

New-AzPrivateDnsRecordSet
   -ResourceGroupName <String>
   -ZoneName <String>
   -Name <String>
   -RecordType <RecordType>
   -Ttl <UInt32>
   [-Metadata <Hashtable>]
   [-PrivateDnsRecord <PSPrivateDnsRecordBase[]>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzPrivateDnsRecordSet
   -Zone <PSPrivateDnsZone>
   -Name <String>
   -RecordType <RecordType>
   -Ttl <UInt32>
   [-Metadata <Hashtable>]
   [-PrivateDnsRecord <PSPrivateDnsRecordBase[]>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzPrivateDnsRecordSet
   -ParentResourceId <String>
   -Name <String>
   -RecordType <RecordType>
   -Ttl <UInt32>
   [-Metadata <Hashtable>]
   [-PrivateDnsRecord <PSPrivateDnsRecordBase[]>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

New-AzPrivateDnsRecordSet コマンドレットは、指定したプライベートゾーンに指定した名前と種類を持つ新しいプライベートドメインネームシステム (DNS) レコードセットを作成します。 RecordSet オブジェクトは、同じ名前と種類のプライベート DNS レコードのセットです。名前は、完全修飾名ではなく、プライベートゾーンに対して相対的であることに注意してください。 PrivateDnsRecord パラメーターは、レコードセット内のレコードを指定します。このパラメーターは、New-AzPrivateDnsRecordConfig を使用して構築されたプライベート DNS レコードの配列を受け取ります。パイプライン演算子を使用して PSPrivateDnsZone オブジェクトをこのコマンドレットに渡すか、PSPrivateDnsZone オブジェクトを Zone パラメーターとして渡すか、ResourceId でゾーンを指定するか、またはゾーンを名前で指定できます。 Confirm パラメーターと Windows PowerShell 変数$ConfirmPreference使用して、コマンドレットで確認を求めるメッセージを表示するかどうかを制御できます。一致する RecordSet が既に存在する場合 (同じ名前とレコードの種類)、Overwrite パラメーターを指定する必要があります。それ以外の場合、コマンドレットは新しい RecordSet を作成しません。

例

例 1: A 型の RecordSet を作成する

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -IPv4Address 1.2.3.4
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

# When creating a RecordSet containing a single record, the above sequence can also be condensed into a single line:

$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords (New-AzPrivateDnsRecordConfig -IPv4Address 1.2.3.4)

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/providers/Microsoft.Netwo
                    rk/privateDnsZones/myzone.com/A/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {1.2.3.4}
Metadata          :
IsAutoRegistered  :


# To create a record set containing multiple records, use New-AzPrivateDnsRecordConfig to add each record to the $Records array,
# then call New-AzPrivateDnsRecordSet, as follows:

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -IPv4Address 1.2.3.4
$Records += New-AzPrivateDnsRecordConfig -IPv4Address 5.6.7.8
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/providers/Microsoft.Netwo
                    rk/privateDnsZones/myzone.com/A/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {1.2.3.4, 5.6.7.8}
Metadata          :
IsAutoRegistered  :

次の使用例は、プライベートゾーン myzone.com に www という名前の RecordSet を作成します。レコードセットの種類は A で、TTL は 1 時間 (3600 秒) です。これには、1 つのプライベート DNS レコードが含まれています。

例 2: AAAA タイプの RecordSet を作成する

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Ipv6Address 2001:db8::1
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType AAAA -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/AAAA/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : AAAA
Records           : {2001:db8::1}
Metadata          :
IsAutoRegistered  :

次の使用例は、プライベートゾーン myzone.com に www という名前の RecordSet を作成します。レコードセットの種類は AAAA で、TTL は 1 時間 (3600 秒) です。これには、1 つのプライベート DNS レコードが含まれています。 1 行のpn_PowerShell_shortのみを使用して RecordSet を作成する場合、または複数のレコードを含むレコードセットを作成するには、例 1 を参照してください。

例 3: CNAME 型の RecordSet を作成する

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Cname www.contoso.com
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType CNAME -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/CNAME/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : CNAME
Records           : {www.contoso.com}
Metadata          :
IsAutoRegistered  :

次の使用例は、プライベートゾーン myzone.com に www という名前の RecordSet を作成します。レコードセットは CNAME 型で、TTL は 1 時間 (3600 秒) です。これには、1 つのプライベート DNS レコードが含まれています。 1 行のpn_PowerShell_shortのみを使用して RecordSet を作成する場合、または複数のレコードを含むレコードセットを作成するには、例 1 を参照してください。

例 4: MX 型の RecordSet を作成する

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Exchange "mail.microsoft.com" -Preference 5
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType MX -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/MX/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : MX
Records           : {[5,mail.microsoft.com]}
Metadata          :
IsAutoRegistered  :

このコマンドは、プライベートゾーン myzone.com に www という名前の RecordSet を作成します。レコードセットの種類は MX で、TTL は 1 時間 (3600 秒) です。これには、1 つのプライベート DNS レコードが含まれています。 1 行のpn_PowerShell_shortのみを使用して RecordSet を作成する場合、または複数のレコードを含むレコードセットを作成するには、例 1 を参照してください。

例 5: PTR 型の RecordSet を作成する

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Ptrdname www.contoso.com
$RecordSet = New-AzPrivateDnsRecordSet -Name "4" -RecordType PTR -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "3.2.1.in-addr.arpa" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/3.2.1.in-addr.arpa/PTR/4
Name              : 4
ZoneName          : 3.2.1.in-addr.arpa
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : PTR
Records           : {www.contoso.com}
Metadata          :
IsAutoRegistered  :

このコマンドは、プライベートゾーン 3.2.1.in-addr.arpa に 4 という名前の RecordSet を作成します。レコードセットの種類は PTR で、TTL は 1 時間 (3600 秒) です。これには、1 つのプライベート DNS レコードが含まれています。 1 行のpn_PowerShell_shortのみを使用して RecordSet を作成する場合、または複数のレコードを含むレコードセットを作成するには、例 1 を参照してください。

例 6: SRV 型の RecordSet を作成する

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Priority 0 -Weight 5 -Port 8080 -Target sipservice.contoso.com
$RecordSet = New-AzPrivateDnsRecordSet -Name "_sip._tcp" -RecordType SRV -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/SRV/_sip._tcp
Name              : _sip._tcp
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : SRV
Records           : {[0,5,8080,sipservice.contoso.com]}
Metadata          :
IsAutoRegistered  :

このコマンドは、プライベートゾーン myzone.com に _sip._tcp という名前の RecordSet を作成します。レコードセットの種類は SRV で、TTL は 1 時間 (3600 秒) です。 IP アドレス 2001.2.3.4 を指す 1 つのプライベート DNS レコードが含まれています。サービス (sip) とプロトコル (tcp) は、レコードデータの一部ではなく、レコードセット名の一部として指定されます。 1 行のpn_PowerShell_shortのみを使用して RecordSet を作成する場合、または複数のレコードを含むレコードセットを作成するには、例 1 を参照してください。

例 7: TXT 型の RecordSet を作成する

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Value "This is a TXT Record"
$RecordSet = New-AzPrivateDnsRecordSet -Name "text" -RecordType TXT -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/TXT/text
Name              : text
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : TXT
Records           : {This is a TXT Record}
Metadata          :
IsAutoRegistered  :

このコマンドは、プライベートゾーン myzone.com に RecordSet という名前のテキストを作成します。レコードセットの種類は TXT で、TTL は 1 時間 (3600 秒) です。これには、1 つのプライベート DNS レコードが含まれています。 1 行のpn_PowerShell_shortのみを使用して RecordSet を作成する場合、または複数のレコードを含むレコードセットを作成するには、例 1 を参照してください。

例 8: ゾーンの頂点に RecordSet を作成する

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Ipv4Address 1.2.3.4
$RecordSet = New-AzPrivateDnsRecordSet -Name "@" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/A/@
Name              : @
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {1.2.3.4}
Metadata          :
IsAutoRegistered  :

このコマンドは、プライベートゾーン myzone.com の頂点 (またはルート) に RecordSet を作成します。これを行うには、レコードセット名を "@" (二重引用符を含む) として指定します。ゾーンの頂点に CNAME レコードを作成することはできません。これは DNS 標準の制約です。これは Azure プライベート DNS の制限ではありません。 1 行のpn_PowerShell_shortのみを使用して RecordSet を作成する場合、または複数のレコードを含むレコードセットを作成するには、例 1 を参照してください。

例 9: ワイルドカードレコードセットを作成する

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Ipv4Address 1.2.3.4
$RecordSet = New-AzPrivateDnsRecordSet -Name "*" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/A/@
Name              : *
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {1.2.3.4}
Metadata          :
IsAutoRegistered  :

このコマンドは、プライベートゾーン myzone.com に * という名前の RecordSet を作成します。これはワイルドカードレコードセットです。 1 行のpn_PowerShell_shortのみを使用して RecordSet を作成する場合、または複数のレコードを含むレコードセットを作成するには、例 1 を参照してください。

例 10: 空のレコードセットを作成する

$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords @()

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/A/@
Name              : *
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {}
Metadata          :
IsAutoRegistered  :

このコマンドは、プライベートゾーン myzone.com に * という名前の RecordSet を作成します。レコードセットの種類は A で、TTL は 1 時間 (3600 秒) です。これは空のレコードセットであり、後でレコードを追加できるプレースホルダーとして機能します。

例 11: レコードセットを作成し、すべての確認を抑制する

$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords (New-AzDnsRecordConfig -Ipv4Address 1.2.3.4) -Confirm:$False -Overwrite

このコマンドを実行すると、RecordSet が作成されます。 Overwrite パラメーターを指定すると、このレコードセットによって、同じ名前と種類の既存のレコードセットが上書きされます (そのレコードセット内の既存のレコードは失われます)。値が $False の Confirm パラメーターは、確認プロンプトを抑制します。

パラメーター

-Confirm

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

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

-DefaultProfile

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

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

-Metadata

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

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

-Name

このレコードセット内のレコードの名前 (ゾーンの名前を基準とし、終わるドットを除く)。

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

-Overwrite

レコードセットが既に存在する場合は失敗しません。

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

-ParentResourceId

プライベート DNS ゾーン ResourceID。

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

-PrivateDnsRecord

このレコードセットの一部であるプライベート DNS レコード。

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

-RecordType

このレコードセット内のプライベート DNS レコードの種類。

型:	RecordType
指定可能な値:	A, AAAA, CNAME, MX, PTR, SOA, SRV, TXT
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ResourceGroupName

ゾーンが属するリソースグループ。

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

-Ttl

このレコードセット内のすべてのレコードの TTL 値。

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

-WhatIf

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

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

-Zone

レコードセットを作成するゾーンを表す PrivateDnsZone オブジェクト。

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

-ZoneName

レコードセットを作成するゾーン (終了ドットなし)。

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

入力

PSPrivateDnsZone

String

出力

PSPrivateDnsRecordSet

次の方法で共有

New-AzPrivateDnsRecordSet

構文

説明

例

例 1: A 型の RecordSet を作成する

例 2: AAAA タイプの RecordSet を作成する

例 3: CNAME 型の RecordSet を作成する

例 4: MX 型の RecordSet を作成する

例 5: PTR 型の RecordSet を作成する

例 6: SRV 型の RecordSet を作成する

例 7: TXT 型の RecordSet を作成する

例 8: ゾーンの頂点に RecordSet を作成する

例 9: ワイルドカードレコードセットを作成する

例 10: 空のレコードセットを作成する

例 11: レコードセットを作成し、すべての確認を抑制する

パラメーター

-Confirm

-DefaultProfile

-Metadata

-Name

-Overwrite

-ParentResourceId

-PrivateDnsRecord

-RecordType

-ResourceGroupName

-Ttl

-WhatIf

-Zone

-ZoneName

入力

出力

その他のリソース

次の方法で共有

New-AzPrivateDnsRecordSet

構文

説明

例

例 1: A 型の RecordSet を作成する

例 2: AAAA タイプの RecordSet を作成する

例 3: CNAME 型の RecordSet を作成する

例 4: MX 型の RecordSet を作成する

例 5: PTR 型の RecordSet を作成する

例 6: SRV 型の RecordSet を作成する

例 7: TXT 型の RecordSet を作成する

例 8: ゾーンの頂点に RecordSet を作成する

例 9: ワイルドカード レコード セットを作成する

例 10: 空のレコード セットを作成する

例 11: レコード セットを作成し、すべての確認を抑制する

パラメーター

-Confirm

-DefaultProfile

-Metadata

-Name

-Overwrite

-ParentResourceId

-PrivateDnsRecord

-RecordType

-ResourceGroupName

-Ttl

-WhatIf

-Zone

-ZoneName

入力

出力

その他のリソース

例 9: ワイルドカードレコードセットを作成する

例 10: 空のレコードセットを作成する

例 11: レコードセットを作成し、すべての確認を抑制する