你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

New-AzDnsRecordConfig

模块:

Az.Dns

创建新的 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
   -Flags <UInt16>
   -Order <UInt16>
   -Preference <UInt16>
   -Services <String>
   -Regexp <String>
   -Replacement <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

说明

New-AzDnsRecordConfig cmdlet 创建本地 DnsRecord 对象。 这些对象的数组使用 DnsRecords 参数传递给 New-AzDnsRecordSet cmdlet，以指定要在记录集中创建的记录。

示例

示例 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 秒）。 它包含单个 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 秒）。 它包含单个 DNS 记录。 若要仅使用一行pn_PowerShell_short创建 RecordSet，或创建具有多个记录的记录集，请参阅示例 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 秒）。 它包含单个 DNS 记录。 若要仅使用一行pn_PowerShell_short创建 RecordSet，或创建具有多个记录的记录集，请参阅示例 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 秒）。 它包含单个 DNS 记录。 若要仅使用一行pn_PowerShell_short创建 RecordSet，或创建具有多个记录的记录集，请参阅示例 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 秒）。 它包含单个 DNS 记录。 若要仅使用一行pn_PowerShell_short创建 RecordSet，或创建具有多个记录的记录集，请参阅示例 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 秒）。 它包含单个 DNS 记录。 若要仅使用一行pn_PowerShell_short创建 RecordSet，或创建具有多个记录的记录集，请参阅示例 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 秒）。 它包含单个 DNS 记录，指向 IP 地址 2001.2.3.4。 服务（sip）和协议（tcp）被指定为记录集名称的一部分，而不是记录数据的一部分。 若要仅使用一行pn_PowerShell_short创建 RecordSet，或创建具有多个记录的记录集，请参阅示例 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 秒）。 它包含单个 DNS 记录。 若要仅使用一行pn_PowerShell_short创建 RecordSet，或创建具有多个记录的记录集，请参阅示例 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 中创建名为 childd 的 RecordSet。 记录集的类型为 DS，其 TTL 为 1 小时（3600 秒）。 它包含单个 DNS 记录。 记录数据包含子区域的 DNSKEY 记录的键标记、算法、摘要类型和摘要。 若要仅使用一行pn_PowerShell_short创建 RecordSet，或创建具有多个记录的记录集，请参阅示例 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 秒）。 它包含单个 DNS 记录。 记录数据包含证书关联数据的使用情况、选择器和匹配类型。 若要仅使用一行pn_PowerShell_short创建 RecordSet，或创建具有多个记录的记录集，请参阅示例 1。

示例 11：创建 NAPTR 类型的 RecordSet

$Records = @()
$Records += New-AzDnsRecordConfig -Flags 0 -Order 100 -Preference 100 -Services "SIP+D2U" -Regexp "" -Replacement "example.com"
$RecordSet = New-AzDnsRecordSet -Name "naptr123" -RecordType NAPTR -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

此命令在区域 myzone.com 中创建名为 naptr123 的 RecordSet。 记录集的类型为 NAPTR，其 TTL 为 1 小时（3600 秒）。 它包含单个 DNS 记录。 记录数据包含订单、首选项、标志、服务、正则表达式和替换字段。 若要仅使用一行pn_PowerShell_short创建 RecordSet，或创建具有多个记录的记录集，请参阅示例 1。

参数

-Algorithm

要添加的 DS 记录的算法字段。

类型:	Int32
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-CaaFlags

要添加的 CAA 记录的标志。 必须是介于 0 和 255 之间的数字。

类型:	Byte
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-CaaTag

要添加的 CAA 记录的标记字段。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-CaaValue

要添加的 CAA 记录的值字段。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-CertificateAssociationData

要添加的 TLSA 记录的证书关联数据字段。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Cname

指定规范名称 （CNAME） 记录的域名。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-DefaultProfile

用于与 azure 通信的凭据、帐户、租户和订阅

类型:	IAzureContextContainer
别名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Digest

要添加的 DS 记录的摘要字段。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-DigestType

要添加的 DS 记录的摘要类型字段。

类型:	Int32
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Exchange

指定邮件交换（MX）记录的邮件交换服务器名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Flags

指定 NAPTR 记录的标志。

类型:	UInt16
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Ipv4Address

指定 A 记录的 IPv4 地址。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Ipv6Address

指定 AAAA 记录的 IPv6 地址。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-KeyTag

要添加的 DS 记录的键标记字段。

类型:	Int32
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-MatchingType

要添加的 TLSA 记录的匹配类型字段。

类型:	Int32
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Nsdname

指定名称服务器 （NS） 记录的名称服务器名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Order

指定 NAPTR 记录的顺序。

类型:	UInt16
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Port

指定服务（SRV）记录的端口。

类型:	UInt16
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Preference

指定 MX/NAPTR 记录的首选项。

类型:	UInt16
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Priority

指定 SRV 记录的优先级。

类型:	UInt16
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Ptrdname

指定指针资源（PTR）记录的目标域名。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Regexp

指定 NAPTR 记录的正则表达式。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Replacement

指定 NAPTR 记录的替换项。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Selector

要添加的 TLSA 记录的选择器字段。

类型:	Int32
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Services

指定 NAPTR 记录的服务。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Target

指定 SRV 记录的目标。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Usage

要添加的 TLSA 记录的使用字段。

类型:	Int32
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Value

指定 TXT 记录的值。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Weight

指定 SRV 记录的权重。

类型:	UInt16
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

输入

String

UInt16

Byte

输出

DnsRecordBase

相关链接

• Add-AzDnsRecordConfig
• New-AzDnsRecordSet
• Remove-AzDnsRecordConfig