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
-RecordSet <DnsRecordSet>
-Order <UInt16>
-Preference <UInt16>
-Flags <String>
-Services <String>
-Regexp <String>
-Replacement <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] 説明
Add-AzDnsRecordConfig コマンドレットは、ドメイン ネーム システム (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例 11: レコード セットに NAPTR レコードを追加する
$RecordSet = Get-AzDnsRecordSet -Name www -RecordType NAPTR -ResourceGroupName MyResourceGroup -ZoneName myzone.com
Add-AzDnsRecordConfig -RecordSet $RecordSet -Order 100 -Preference 100 -Flags "s" -Services "http" -Regexp "" -Replacement "www.contoso.com"
Set-AzDnsRecordSet -RecordSet $RecordSet
# The above sequence can also be piped:
Get-AzDnsRecordSet -Name www -RecordType NAPTR -ResourceGroupName MyResourceGroup -ZoneName myzone.com | Add-AzDnsRecordConfig -Order 100 -Preference 100 -Flags "s" -Services "http" -Regexp "" -Replacement "www.contoso.com" | Set-AzDnsRecordSetパラメーター
-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 |
-Flags
名前付き権限ポインター (NAPTR) レコードのフラグを指定します。
| 型: | 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 |
-Order
名前付け権限ポインター (NAPTR) レコードの順序を指定します。
| 型: | UInt16 |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Port
サービス (SRV) レコードのポートを指定します。
| 型: | UInt16 |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Preference
MX/NAPTR レコードの基本設定を指定します。
| 型: | UInt16 |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Priority
SRV レコードの優先順位を指定します。
| 型: | UInt16 |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Ptrdname
ポインター リソース (PTR) レコードのターゲット ドメイン名を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-RecordSet
編集する RecordSet オブジェクトを指定します。
| 型: | DnsRecordSet |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Regexp
名前付き権限ポインター (NAPTR) レコードの regexp フィールドを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Replacement
名前付き権限ポインター (NAPTR) レコードの置換フィールドを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Selector
追加する TLSA レコードのセレクター フィールド。
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Services
名前付き権限ポインター (NAPTR) レコードのサービス フィールドを指定します。
| 型: | String |
| 配置: | 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 |
入力
出力
関連リンク
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
Azure PowerShell