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

New-AzureRmDnsZone

模块:

AzureRM.Dns

创建新的 DNS 区域。

警告

截至 2024 年 2 月 29 日，AzureRM PowerShell 模块已正式弃用。 为了确保持续获得支持和更新，建议用户从 AzureRM 迁移到 Az PowerShell 模块。

尽管 AzureRM 模块仍可能正常运行，但它不再维护或受支持，但会根据用户的自由裁量权和风险继续使用任何继续使用模块。 有关过渡到 Az 模块的指导，请参阅我们的迁移资源。

语法

New-AzureRmDnsZone
   -Name <String>
   -ResourceGroupName <String>
   [-ZoneType <ZoneType>]
   [-Tag <Hashtable>]
   [-RegistrationVirtualNetworkId <System.Collections.Generic.List`1[System.String]>]
   [-ResolutionVirtualNetworkId <System.Collections.Generic.List`1[System.String]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmDnsZone
   -Name <String>
   -ResourceGroupName <String>
   [-ZoneType <ZoneType>]
   [-Tag <Hashtable>]
   [-RegistrationVirtualNetwork <System.Collections.Generic.List`1[Microsoft.Azure.Management.Internal.Network.Common.IResourceReference]>]
   [-ResolutionVirtualNetwork <System.Collections.Generic.List`1[Microsoft.Azure.Management.Internal.Network.Common.IResourceReference]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

New-AzureRmDnsZone cmdlet 在指定的资源组中创建新的域名系统（DNS）区域。 必须为 Name 参数指定唯一的 DNS 区域名称，否则 cmdlet 将返回错误。 创建区域后，使用 New-AzureRmDnsRecordSet cmdlet 在区域中创建记录集。 可以使用 Confirm 参数并$ConfirmPreference Windows PowerShell 变量来控制 cmdlet 是否提示你进行确认。

示例

示例 1：创建 DNS 区域

PS C:\>$Zone = New-AzureRmDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup"

此命令在指定的资源组中创建名为 myzone.com 的新 DNS 区域，然后将其存储在$Zone变量中。

示例 2：通过指定虚拟网络 ID 创建私人 DNS区域

PS C:\>$ResVirtualNetworkId = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testresgroup/providers/Microsoft.Network/virtualNetworks/resvnet"
PS C:\>$Zone = New-AzureRmDnsZone -Name "myprivatezone.com" -ResourceGroupName "MyResourceGroup" -ZoneType Private -ResolutionVirtualNetworkId @($ResVirtualNetworkId)

此命令使用关联的解析虚拟网络（指定其 ID）在指定资源组中创建名为 myprivatezone.com 的新私人 DNS区域，然后将其存储在$Zone变量中。

示例 3：通过指定虚拟网络对象创建私人 DNS区域

PS C:\>$ResVirtualNetwork = Get-AzureRmVirtualNetwork -Name "resvnet" -ResourceGroupName "testresgroup"
PS C:\>$Zone = New-AzureRmDnsZone -Name "myprivatezone.com" -ResourceGroupName "MyResourceGroup" -ZoneType Private -ResolutionVirtualNetwork @($ResVirtualNetwork)

此命令使用关联的解析虚拟网络（$ResVirtualNetwork 变量引用）在指定的资源组中创建名为 myprivatezone.com 的新私人 DNS区域，然后将其存储在$Zone变量中。

参数

-Confirm

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

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

-Name

指定要创建的 DNS 区域的名称。

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

-RegistrationVirtualNetwork

将在此 DNS 区域中注册虚拟机主机名记录的虚拟网络列表，仅适用于专用区域。

Type:	List<T>[IResourceReference]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-RegistrationVirtualNetworkId

将在此 DNS 区域中注册虚拟机主机名记录的虚拟网络 ID 列表，仅适用于专用区域。

Type:	List<T>[String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ResolutionVirtualNetwork

能够解析此 DNS 区域中的记录的虚拟网络列表，仅适用于专用区域。

Type:	List<T>[IResourceReference]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ResolutionVirtualNetworkId

能够解析此 DNS 区域中的记录的虚拟网络 ID 列表，仅适用于专用区域。

Type:	List<T>[String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceGroupName

指定要在其中创建区域的资源组。

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

-Tag

以哈希表的形式进行键值对。 例如：@{key0=“value0”;key1=$null;key2=“value2”}

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

-WhatIf

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

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

-ZoneType

区域的类型，公共或专用。 公共 DNS 服务平面上提供了没有类型或具有公共类型的区域，以便在 DNS 层次结构中使用。 具有专用类型的区域仅在关联的虚拟网络集（此功能为预览版）中可见。 无法更改区域的此属性。

Type:	Nullable<T>[ZoneType]
Accepted values:	Public, Private
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

输入

String

Nullable<T>[[Microsoft.Azure.Management.Dns.Models.ZoneType, Microsoft.Azure.Management.Dns, Version=2.1.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

Hashtable

List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

List<T>[[Microsoft.Azure.Management.Internal.Network.Common.IResourceReference, Microsoft.Azure.Commands.Common.Network, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]

输出

DnsZone

备注

可以使用 Confirm 参数来控制此 cmdlet 是否提示你进行确认。 默认情况下，如果 $ConfirmPreference Windows PowerShell 变量的值为“中”或“较低”，cmdlet 会提示你进行确认。 如果指定“确认”或“确认：$True”，则此 cmdlet 会在运行之前提示你进行确认。 如果指定 Confirm：$False，cmdlet 不会提示你进行确认。

相关链接

• Get-AzureRmDnsZone
• New-AzureRmDnsRecordSet
• Remove-AzureRmDnsZone