Add-AzDnsRecordConfig

DNS レコードをローカル レコード セット オブジェクトに追加します。

構文

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

説明

Add-AzDnsRecordConfig コマンドレットは、Doメイン Name System (DNS) レコードを RecordSet オブジェクトに追加します。 RecordSet オブジェクトはオフライン オブジェクトであり、それに対する変更は、Set-AzDnsRecordSet コマンドレットを実行して Microsoft Azure DNS サービスへの変更を保持するまで DNS 応答を変更しません。 SOA レコードは DNS ゾーンの作成時に作成され、DNS ゾーンが削除されると削除されます。 SOA レコードを追加または削除することはできませんが、編集することはできます。 パラメーターとして、またはパイプライン演算子を使用して、このコマンドレットに RecordSet オブジェクトを渡すことができます。

例 1: A レコードをレコード セットに追加する

$RecordSet = Get-AzDnsRecordSet -Name www -RecordType A -ResourceGroupName MyResourceGroup -ZoneName myzone.com
Add-AzDnsRecordConfig -RecordSet $RecordSet -Ipv4Address 1.2.3.4
Set-AzDnsRecordSet -RecordSet $RecordSet

# You can also pipe the above sequence:

Get-AzDnsRecordSet -Name www -RecordType A -ResourceGroupName MyResourceGroup -ZoneName myzone.com | Add-AzDnsRecordConfig -Ipv4Address 1.2.3.4 | Set-AzDnsRecordSet

次の使用例は、A レコードを既存のレコード セットに追加します。

例 2: AAAA レコードをレコード セットに追加する

$RecordSet = Get-AzDnsRecordSet -Name www -RecordType AAAA -ResourceGroupName MyResourceGroup -ZoneName myzone.com
Add-AzDnsRecordConfig -RecordSet $RecordSet -Ipv6Address 2001:DB80:4009:1803::1005
Set-AzDnsRecordSet -RecordSet $RecordSet

# You can also pipe the above sequence:

Get-AzDnsRecordSet -Name www -RecordType AAAA -ResourceGroupName MyResourceGroup -ZoneName myzone.com | Add-AzDnsRecordConfig -Ipv6Address 2001:DB80:4009:1803::1005 | Set-AzDnsRecordSet

次の使用例は、AAAA レコードを既存のレコード セットに追加します。

例 3: CNAME レコードをレコード セットに追加する

$RecordSet = Get-AzDnsRecordSet -Name www -RecordType CNAME -ResourceGroupName MyResourceGroup -ZoneName myzone.com
Add-AzDnsRecordConfig -RecordSet $RecordSet -Cname contoso.com
Set-AzDnsRecordSet -RecordSet $RecordSet

# You can also pipe the above sequence:

Get-AzDnsRecordSet -Name www -RecordType CNAME -ResourceGroupName MyResourceGroup -ZoneName myzone.com | Add-AzDnsRecordConfig -Cname contoso.com | Set-AzDnsRecordSet

次の使用例は、既存のレコード セットに CNAME レコードを追加します。 CNAME レコード セットには最大 1 つのレコードを含めることができるため、最初は空のレコード セットであるか、Remove-AzDnsRecordConfig を使用して既存のレコードを削除する必要があります。

例 4: MX レコードをレコード セットに追加する

$RecordSet = Get-AzDnsRecordSet -Name "@" -RecordType MX -ResourceGroupName MyResourceGroup -ZoneName myzone.com
Add-AzDnsRecordConfig -Exchange mail.microsoft.com -Preference 5 -RecordSet $RecordSet
Set-AzDnsRecordSet -RecordSet $RecordSet

# You can also pipe the above sequence:

Get-AzDnsRecordSet -Name "@" -RecordType MX -ResourceGroupName MyResourceGroup -ZoneName myzone.com | Add-AzDnsRecordConfig -Exchange mail.microsoft.com -Preference 5 | Set-AzDnsRecordSet

次の使用例は、既存のレコード セットに MX レコードを追加します。 レコード名 "@" は、ゾーンの頂点にあるレコード セットを示します。

例 5: レコード セットに NS レコードを追加する

$RecordSet = Get-AzDnsRecordSet -Name abc -RecordType NS -ResourceGroupName MyResourceGroup -ZoneName myzone.com
Add-AzDnsRecordConfig -Nsdname ns1.myzone.com -RecordSet $RecordSet
Set-AzDnsRecordSet -RecordSet $RecordSet

# You can also pipe the above sequence:

Get-AzDnsRecordSet -Name abc -RecordType NS -ResourceGroupName MyResourceGroup -ZoneName myzone.com | Add-AzDnsRecordConfig -Nsdname ns1.myzone.com | Set-AzDnsRecordSet

次の使用例は、既存のレコード セットに NS レコードを追加します。

例 6: PTR レコードをレコード セットに追加する

$RecordSet = Get-AzDnsRecordSet -Name 4 -RecordType PTR -ResourceGroupName MyResourceGroup -ZoneName 3.2.1.in-addr.arpa
Add-AzDnsRecordConfig -Ptrdname www.contoso.com -RecordSet $RecordSet
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name 4 -RecordType PTR -ResourceGroupName MyResourceGroup -ZoneName 3.2.1.in-addr.arpa | Add-AzDnsRecordConfig -Ptrdname www.contoso.com | Set-AzDnsRecordSet

次の使用例は、既存のレコード セットに PTR レコードを追加します。

例 7: SRV レコードをレコード・セットに追加する

$RecordSet = Get-AzDnsRecordSet -Name _sip._tcp -RecordType SRV -ResourceGroupName MyResourceGroup -ZoneName myzone.com
Add-AzDnsRecordConfig -RecordSet $RecordSet -Priority 0 -Weight 5 -Port 8080 -Target target.example.com
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name _sip._tcp -RecordType SRV -ResourceGroupName MyResourceGroup -ZoneName myzone.com | Add-AzDnsRecordConfig -Priority 0 -Weight 5 -Port 8080 -Target target.example.com  | Set-AzDnsRecordSet

次の使用例は、既存のレコード セットに SRV レコードを追加します。

例 8: TXT レコードをレコード セットに追加する

$RecordSet = Get-AzDnsRecordSet -Name text -RecordType TXT -ResourceGroupName MyResourceGroup -ZoneName myzone.com
Add-AzDnsRecordConfig -RecordSet $RecordSet -Value "This is a TXT Record"
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name text -RecordType TXT -ResourceGroupName MyResourceGroup -ZoneName myzone.com | Add-AzDnsRecordConfig -Value "This is a TXT Record" | Set-AzDnsRecordSet

次の使用例は、TXT レコードを既存のレコード セットに追加します。

例 9: DS レコードをレコード・セットに追加する

$RecordSet = Get-AzDnsRecordSet -Name www -RecordType DS -ResourceGroupName MyResourceGroup -ZoneName myzone.com
Add-AzDnsRecordConfig -RecordSet $RecordSet -KeyTag 12345 -Algorithm 3 -DigestType 1 -Digest "49FD46E6C4B45C55D4AC"
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name www -RecordType DS -ResourceGroupName MyResourceGroup -ZoneName myzone.com | Add-AzDnsRecordConfig -KeyTag 12345 -Algorithm 3 -DigestType 1 -Digest "49FD46E6C4B45C55D4AC" | Set-AzDnsRecordSet

例 10: TLSA レコードをレコード セットに追加する

$RecordSet = Get-AzDnsRecordSet -Name _443._tcp.www -RecordType TLSA -ResourceGroupName MyResourceGroup -ZoneName myzone.com
Add-AzDnsRecordConfig -RecordSet $RecordSet -Usage 3 -Selector 1 -MatchingType 1 -CertificateAssociationData "49FD46E6C4B45C55D4AC"
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name _443._tcp.www -RecordType TLSA -ResourceGroupName MyResourceGroup -ZoneName myzone.com | Add-AzDnsRecordConfig -Usage 3 -Selector 1 -MatchingType 1 -CertificateAssociationData "49FD46E6C4B45C55D4AC" | Set-AzDnsRecordSet

パラメーター

-Algorithm

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

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

-CaaFlags

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

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

-CaaTag

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

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

-CaaValue

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

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

-CertificateAssociationData

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

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

-Cname

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

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

-Digest

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

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

-DigestType

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

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

-Exchange

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

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

-Ipv4Address

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

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

-Ipv6Address

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

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

-KeyTag

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

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

-MatchingType

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

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

-Nsdname

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

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

-Port

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

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

-Preference

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

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

-Priority

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

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

-Ptrdname

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

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

-RecordSet

編集する RecordSet オブジェクトを指定します。

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

-Selector

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

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

-Target

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

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

-Usage

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

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

-Value

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

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

-Weight

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

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

入力

DnsRecordSet

String

UInt16

Byte

出力

DnsRecordSet