英語で読む

次の方法で共有


New-AzDnsRecordConfig

新しい DNS レコードのローカル オブジェクトを作成します。

構文

New-AzDnsRecordConfig
   -Ipv4Address <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzDnsRecordConfig
   -Ipv6Address <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzDnsRecordConfig
   -Nsdname <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzDnsRecordConfig
   -Exchange <String>
   -Preference <UInt16>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzDnsRecordConfig
   -Ptrdname <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzDnsRecordConfig
   -Value <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzDnsRecordConfig
   -Priority <UInt16>
   -Target <String>
   -Port <UInt16>
   -Weight <UInt16>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzDnsRecordConfig
   -Cname <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzDnsRecordConfig
   -CaaFlags <Byte>
   -CaaTag <String>
   -CaaValue <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzDnsRecordConfig
   -KeyTag <Int32>
   -Algorithm <Int32>
   -DigestType <Int32>
   -Digest <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzDnsRecordConfig
   -Usage <Int32>
   -Selector <Int32>
   -MatchingType <Int32>
   -CertificateAssociationData <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

説明

New-AzDnsRecordConfig コマンドレットは、ローカル DnsRecord オブジェクトを作成します。 これらのオブジェクトの配列は、 DnsRecords パラメーターを使用して New-AzDnsRecordSet コマンドレットに渡され、レコード セットに作成するレコードを指定します。

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

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

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

$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords (New-AzDnsRecordConfig -IPv4Address 1.2.3.4)

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

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

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

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

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

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

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

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

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

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

$Records = @()
$Records += New-AzDnsRecordConfig -Exchange "mail.microsoft.com" -Preference 5
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType AAAA -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

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

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

$Records = @()
$Records += New-AzDnsRecordConfig -Nsdname ns1-01.azure-dns.com
$RecordSet = New-AzDnsRecordSet -Name "ns1" -RecordType NS -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

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

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

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

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

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

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

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

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

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

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

例 9: DS 型の RecordSet を作成する

$Records = @()
$Records += New-AzDnsRecordConfig -KeyTag 12345 -Algorithm 3 -DigestType 1 -Digest "49FD46E6C4B45C55D4AC"
$RecordSet = New-AzDnsRecordSet -Name "childds" -RecordType DS -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

このコマンドは、ゾーン myzone.com に名前付き子RecordSet を作成します。 レコード セットは DS 型で、TTL は 1 時間 (3600 秒) です。 1 つの DNS レコードが含まれています。 レコード データには、子ゾーンの DNSKEY レコードのキー タグ、アルゴリズム、ダイジェストの種類、ダイジェストが含まれています。 RecordSet を作成するには 1 行のpn_PowerShell_shortのみを使用するか、複数のレコードを含むレコード セットを作成するには、例 1 を参照してください。

例 10: TLSA 型の RecordSet を作成する

$Records = @()
$Records += New-AzDnsRecordConfig -Usage 3 -Selector 1 -MatchingType 1 -CertificateAssociationData "49FD46E6C4B45C55D4AC"
$RecordSet = New-AzDnsRecordSet -Name "_443._tcp.www" -RecordType TLSA -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

このコマンドは、ゾーン myzone.com に _443._tcp.www という名前の RecordSet を作成します。 レコード セットの種類は TLSA で、TTL は 1 時間 (3600 秒) です。 1 つの DNS レコードが含まれています。 レコード データには、証明書の関連付けデータの使用法、セレクター、および一致する種類が含まれます。 RecordSet を作成するには 1 行のpn_PowerShell_shortのみを使用するか、複数のレコードを含むレコード セットを作成するには、例 1 を参照してください。

パラメーター

-Algorithm

追加する DS レコードのアルゴリズム フィールド。

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

-CaaFlags

追加する CAA レコードのフラグ。 0 ~ 255 の数値を指定する必要があります。

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

-CaaTag

追加する CAA レコードのタグ フィールド。

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

-CaaValue

追加する CAA レコードの値フィールド。

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

-CertificateAssociationData

追加する TLSA レコードの証明書関連付けデータ フィールド。

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

-Cname

正規名 (CNAME) レコードのドメイン名を指定します。

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

-DefaultProfile

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

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

-Digest

追加する DS レコードのダイジェスト フィールド。

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

-DigestType

追加する DS レコードのダイジェストの種類フィールド。

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

-Exchange

メール交換 (MX) レコードのメール交換サーバー名を指定します。

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

-Ipv4Address

A レコードの IPv4 アドレスを指定します。

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

-Ipv6Address

AAAA レコードの IPv6 アドレスを指定します。

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

-KeyTag

追加する DS レコードのキー タグ フィールド。

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

-MatchingType

追加する TLSA レコードの一致する型フィールド。

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

-Nsdname

ネーム サーバー (NS) レコードのネーム サーバー名を指定します。

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

-Port

サービス (SRV) レコードのポートを指定します。

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

-Preference

MX レコードの基本設定を指定します。

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

-Priority

SRV レコードの優先順位を指定します。

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

-Ptrdname

ポインター リソース (PTR) レコードのターゲット ドメイン名を指定します。

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

-Selector

追加する TLSA レコードのセレクター フィールド。

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

-Target

SRV レコードのターゲットを指定します。

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

-Usage

追加する TLSA レコードの使用状況フィールド。

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

-Value

TXT レコードの値を指定します。

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

-Weight

SRV レコードの重みを指定します。

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

入力

String

UInt16

Byte

出力

DnsRecordBase