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

New-AzPrivateDnsRecordSet

参考

模块:: Az.PrivateDns

在私人 DNS区域中创建记录集。

语法

New-AzPrivateDnsRecordSet
   -ResourceGroupName <String>
   -ZoneName <String>
   -Name <String>
   -RecordType <RecordType>
   -Ttl <UInt32>
   [-Metadata <Hashtable>]
   [-PrivateDnsRecord <PSPrivateDnsRecordBase[]>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzPrivateDnsRecordSet
   -Zone <PSPrivateDnsZone>
   -Name <String>
   -RecordType <RecordType>
   -Ttl <UInt32>
   [-Metadata <Hashtable>]
   [-PrivateDnsRecord <PSPrivateDnsRecordBase[]>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzPrivateDnsRecordSet
   -ParentResourceId <String>
   -Name <String>
   -RecordType <RecordType>
   -Ttl <UInt32>
   [-Metadata <Hashtable>]
   [-PrivateDnsRecord <PSPrivateDnsRecordBase[]>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

New-AzPrivateDnsRecordSet cmdlet 使用指定的专用区域创建一个新的专用域名系统（DNS）记录集，并在指定的专用区域中键入。 RecordSet 对象是一组具有相同名称和类型的私人 DNS记录。请注意，该名称相对于专用区域，而不是完全限定的名称。 PrivateDnsRecord 参数指定记录集中的记录。此参数采用使用 New-AzPrivateDnsRecordConfig 构造的私人 DNS记录数组。可以使用管道运算符将 PSPrivateDnsZone 对象传递给此 cmdlet，也可以将 PSPrivateDnsZone 对象作为 Zone 参数传递，也可以按 ResourceId 指定区域，或者也可以按名称指定区域。可以使用 Confirm 参数和 $ConfirmPreference Windows PowerShell 变量来控制 cmdlet 是否提示你进行确认。如果匹配的 RecordSet 已存在（同名和记录类型），则必须指定 Overwrite 参数，否则 cmdlet 将不会创建新的 RecordSet。

示例

示例 1：创建 A 类型的 RecordSet

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

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

$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords (New-AzPrivateDnsRecordConfig -IPv4Address 1.2.3.4)

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/providers/Microsoft.Netwo
                    rk/privateDnsZones/myzone.com/A/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {1.2.3.4}
Metadata          :
IsAutoRegistered  :


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

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

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/providers/Microsoft.Netwo
                    rk/privateDnsZones/myzone.com/A/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {1.2.3.4, 5.6.7.8}
Metadata          :
IsAutoRegistered  :

此示例在专用区域中创建名为 www 的 RecordSet myzone.com。记录集的类型为 A，其 TTL 为 1 小时（3600 秒）。它包含单个私人 DNS记录。

示例 2：创建 AAAA 类型的 RecordSet

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

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/AAAA/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : AAAA
Records           : {2001:db8::1}
Metadata          :
IsAutoRegistered  :

此示例在专用区域中创建名为 www 的 RecordSet myzone.com。记录集的类型为 AAAA，其 TTL 为 1 小时（3600 秒）。它包含单个私人 DNS记录。若要仅使用一行pn_PowerShell_short创建 RecordSet，或创建包含多个记录的记录集，请参阅示例 1。

示例 3：创建 CNAME 类型的 RecordSet

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

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/CNAME/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : CNAME
Records           : {www.contoso.com}
Metadata          :
IsAutoRegistered  :

此示例在专用区域中创建名为 www 的 RecordSet myzone.com。记录集的类型为 CNAME，其 TTL 为 1 小时（3600 秒）。它包含单个私人 DNS记录。若要仅使用一行pn_PowerShell_short创建 RecordSet，或创建包含多个记录的记录集，请参阅示例 1。

示例 4：创建 MX 类型的 RecordSet

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Exchange "mail.microsoft.com" -Preference 5
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType MX -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/MX/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : MX
Records           : {[5,mail.microsoft.com]}
Metadata          :
IsAutoRegistered  :

此命令在专用区域中创建名为 www 的 RecordSet myzone.com。记录集的类型为 MX，其 TTL 为 1 小时（3600 秒）。它包含单个私人 DNS记录。若要仅使用一行pn_PowerShell_short创建 RecordSet，或创建包含多个记录的记录集，请参阅示例 1。

示例 5：创建 PTR 类型的 RecordSet

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

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/3.2.1.in-addr.arpa/PTR/4
Name              : 4
ZoneName          : 3.2.1.in-addr.arpa
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : PTR
Records           : {www.contoso.com}
Metadata          :
IsAutoRegistered  :

此命令在专用区域 3.2.1.in-addr.arpa 中创建名为 4 的 RecordSet。记录集的类型为 PTR，其 TTL 为 1 小时（3600 秒）。它包含单个私人 DNS记录。若要仅使用一行pn_PowerShell_short创建 RecordSet，或创建包含多个记录的记录集，请参阅示例 1。

示例 6：创建 SRV 类型的 RecordSet

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

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/SRV/_sip._tcp
Name              : _sip._tcp
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : SRV
Records           : {[0,5,8080,sipservice.contoso.com]}
Metadata          :
IsAutoRegistered  :

此命令在专用区域 myzone.com 创建名为 _sip._tcp 的 RecordSet。记录集的类型为 SRV，其 TTL 为 1 小时（3600 秒）。它包含单个私人 DNS记录，指向 IP 地址 2001.2.3.4。服务（sip）和协议（tcp）被指定为记录集名称的一部分，而不是记录数据的一部分。若要仅使用一行pn_PowerShell_short创建 RecordSet，或创建包含多个记录的记录集，请参阅示例 1。

示例 7：创建 TXT 类型的 RecordSet

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

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/TXT/text
Name              : text
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : TXT
Records           : {This is a TXT Record}
Metadata          :
IsAutoRegistered  :

此命令在专用区域中创建一个名为 text 的 RecordSet myzone.com。记录集的类型为 TXT，其 TTL 为 1 小时（3600 秒）。它包含单个私人 DNS记录。若要仅使用一行pn_PowerShell_short创建 RecordSet，或创建包含多个记录的记录集，请参阅示例 1。

示例 8：在区域顶点创建 RecordSet

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Ipv4Address 1.2.3.4
$RecordSet = New-AzPrivateDnsRecordSet -Name "@" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/A/@
Name              : @
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {1.2.3.4}
Metadata          :
IsAutoRegistered  :

此命令在专用区域 myzone.com 顶点（或根）创建 RecordSet。为此，记录集名称指定为“@”（包括双引号）。不能在区域的顶点创建 CNAME 记录。这是 DNS 标准的约束;它不是 Azure 私人 DNS的限制。若要仅使用一行pn_PowerShell_short创建 RecordSet，或创建包含多个记录的记录集，请参阅示例 1。

示例 9：创建野生卡记录集

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Ipv4Address 1.2.3.4
$RecordSet = New-AzPrivateDnsRecordSet -Name "*" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/A/@
Name              : *
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {1.2.3.4}
Metadata          :
IsAutoRegistered  :

此命令在专用区域中创建名为 * 的 RecordSet myzone.com。这是一个野生卡记录集。若要仅使用一行pn_PowerShell_short创建 RecordSet，或创建包含多个记录的记录集，请参阅示例 1。

示例 10：创建空的记录集

$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords @()

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/A/@
Name              : *
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {}
Metadata          :
IsAutoRegistered  :

此命令在专用区域中创建名为 * 的 RecordSet myzone.com。记录集的类型为 A，其 TTL 为 1 小时（3600 秒）。这是一个空记录集，充当可以稍后向其添加记录的占位符。

示例 11：创建记录集并取消所有确认

$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords (New-AzDnsRecordConfig -Ipv4Address 1.2.3.4) -Confirm:$False -Overwrite

此命令创建 RecordSet。 Overwrite 参数可确保此记录集覆盖具有相同名称和类型的任何预先存在的记录集（该记录集中的现有记录丢失）。具有值$False的 Confirm 参数将取消确认提示。

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
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

-Metadata

表示资源标记的哈希表。

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

-Name

此记录集中的记录的名称（相对于区域的名称和没有终止点）。

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

-Overwrite

如果记录集已存在，请不要失败。

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

-ParentResourceId

私人 DNS区域 ResourceID。

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

-PrivateDnsRecord

属于此记录集的专用 dns 记录。

Type:	PSPrivateDnsRecordBase[]
Aliases:	PrivateDnsRecords
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RecordType

此记录集中私人 DNS记录的类型。

Type:	RecordType
Accepted values:	A, AAAA, CNAME, MX, PTR, SOA, SRV, TXT
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

区域所属的资源组。

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

-Ttl

此记录集中所有记录的 TTL 值。

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

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Zone

表示在其中创建记录集的区域的 PrivateDnsZone 对象。

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

-ZoneName

要在其中创建记录集的区域（没有终止点）。

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

输入

PSPrivateDnsZone

String

输出

PSPrivateDnsRecordSet