你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
New-AzureRmDnsRecordConfig
创建新的 DNS 记录本地对象。
警告
截至 2024 年 2 月 29 日,AzureRM PowerShell 模块已正式弃用。 为了确保持续获得支持和更新,建议用户从 AzureRM 迁移到 Az PowerShell 模块。
尽管 AzureRM 模块仍可能正常运行,但它不再维护或受支持,但会根据用户的自由裁量权和风险继续使用任何继续使用模块。 有关过渡到 Az 模块的指导,请参阅我们的迁移资源。
语法
New-AzureRmDnsRecordConfig
-Ipv4Address <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzureRmDnsRecordConfig
-Ipv6Address <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzureRmDnsRecordConfig
-Nsdname <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzureRmDnsRecordConfig
-Exchange <String>
-Preference <UInt16>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzureRmDnsRecordConfig
-Ptrdname <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzureRmDnsRecordConfig
-Value <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzureRmDnsRecordConfig
-Priority <UInt16>
-Target <String>
-Port <UInt16>
-Weight <UInt16>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzureRmDnsRecordConfig
-Cname <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzureRmDnsRecordConfig
-CaaFlags <Byte>
-CaaTag <String>
-CaaValue <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
说明
New-AzureRmDnsRecordConfig cmdlet 创建本地 DnsRecord 对象。 这些对象的数组使用 DnsRecords 参数将传递给 New-AzureRmDnsRecordSet cmdlet,以指定要在记录集中创建的记录。
示例
示例 1:创建 A 类型的 RecordSet
PS C:\> $Records = @()
PS C:\> $Records += New-AzureRmDnsRecordConfig -IPv4Address 1.2.3.4
PS C:\> $RecordSet = New-AzureRmDnsRecordSet -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:
PS C:\> $RecordSet = New-AzureRmDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords (New-AzureRmDnsRecordConfig -IPv4Address 1.2.3.4)
# To create a record set containing multiple records, use New-AzureRmDnsRecordConfig to add each record to the $Records array,
# then call New-AzureRmDnsRecordSet, as follows:
PS C:\> $Records = @()
PS C:\> $Records += New-AzureRmDnsRecordConfig -IPv4Address 1.2.3.4
PS C:\> $Records += New-AzureRmDnsRecordConfig -IPv4Address 5.6.7.8
PS C:\> $RecordSet = New-AzureRmDnsRecordSet -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
PS C:\> $Records = @()
PS C:\> $Records += New-AzureRmDnsRecordConfig -Ipv6Address 2001:db8::1
PS C:\> $RecordSet = New-AzureRmDnsRecordSet -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
PS C:\> $Records = @()
PS C:\> $Records += New-AzureRmDnsRecordConfig -Cname www.contoso.com
PS C:\> $RecordSet = New-AzureRmDnsRecordSet -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
PS C:\> $Records = @()
PS C:\> $Records += New-AzureRmDnsRecordConfig -Exchange "mail.microsoft.com" -Preference 5
PS C:\> $RecordSet = New-AzureRmDnsRecordSet -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
PS C:\> $Records = @()
PS C:\> $Records += New-AzureRmDnsRecordConfig -Nsdname ns1-01.azure-dns.com
PS C:\> $RecordSet = New-AzureRmDnsRecordSet -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
PS C:\> $Records = @()
PS C:\> $Records += New-AzureRmDnsRecordConfig -Ptrdname www.contoso.com
PS C:\> $RecordSet = New-AzureRmDnsRecordSet -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
PS C:\> $Records = @()
PS C:\> $Records += New-AzureRmDnsRecordConfig -Priority 0 -Weight 5 -Port 8080 -Target sipservice.contoso.com
PS C:\> $RecordSet = New-AzureRmDnsRecordSet -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
PS C:\> $Records = @()
PS C:\> $Records += New-AzureRmDnsRecordConfig -Value "This is a TXT Record"
PS C:\> $RecordSet = New-AzureRmDnsRecordSet -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。
参数
-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 |
-Cname
指定规范名称 (CNAME) 记录的域名。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
用于与 azure 通信的凭据、帐户、租户和订阅
Type: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
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 |
-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)记录的目标域名。
Type: | String |
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 |
-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 |