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

New-AzDnsZone

  • 参考
模块:
Az.Dns

创建新的 DNS 区域。

语法

New-AzDnsZone
   -Name <String>
   -ResourceGroupName <String>
   [-ZoneType <ZoneType>]
   [-ParentZoneId <String>]
   [-Tag <Hashtable>]
   [-RegistrationVirtualNetworkId <System.Collections.Generic.List`1[System.String]>]
   [-ResolutionVirtualNetworkId <System.Collections.Generic.List`1[System.String]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDnsZone
   -Name <String>
   -ResourceGroupName <String>
   [-ZoneType <ZoneType>]
   [-ParentZoneName <String>]
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDnsZone
   -Name <String>
   -ResourceGroupName <String>
   [-ZoneType <ZoneType>]
   [-ParentZone <DnsZone>]
   [-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-AzDnsZone cmdlet 在指定的资源组中创建新的域名系统（DNS）区域。 必须为 Name 参数指定唯一的 DNS 区域名称，否则 cmdlet 将返回错误。 创建区域后，使用 New-AzDnsRecordSet cmdlet 在区域中创建记录集。 可以使用 Confirm 参数并$ConfirmPreference Windows PowerShell 变量来控制 cmdlet 是否提示你进行确认。

示例

示例 1：创建 DNS 区域

$Zone = New-AzDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup"

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

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

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

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

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

$ResVirtualNetwork = Get-AzVirtualNetwork -Name "resvnet" -ResourceGroupName "testresgroup"
$Zone = New-AzDnsZone -Name "myprivatezone.com" -ResourceGroupName "MyResourceGroup" -ZoneType Private -ResolutionVirtualNetwork @($ResVirtualNetwork)

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

示例 4：通过指定父区域名称创建具有委派的 DNS 区域

$Zone = New-AzDnsZone -Name "mychild.zone.com" -ResourceGroupName "MyResourceGroup" -ParentZoneName "zone.com"

此命令在指定的资源组中创建一个名为 mychild.zone.com 的新子 DNS 区域，并将其存储在$Zone变量中。 它还会在名为 zone.com 的父 DNS 区域中添加委派，这些委托与子区域位于同一订阅和资源组中。

示例 5：通过指定父区域 ID 创建具有委派的 DNS 区域

$Zone = New-AzDnsZone -Name "mychild.zone.com" -ResourceGroupName "MyResourceGroup" -ParentZoneId "/subscriptions/**67e2/resourceGroups/other-rg/providers/Microsoft.Network/dnszones/zone.com"

此命令在指定的资源组中创建一个名为 mychild.zone.com 的新子 DNS 区域，并将其存储在$Zone变量中。 它还在资源组 other-rg 提供的订阅中名为 zone.com 的父 DNS 区域中添加委派与创建子区域的委托相同。

示例 6：通过指定父区域对象创建具有委派的 DNS 区域

$PZone = New-AzDnsZone -Name "zone.com" -ResourceGroupName "MyResourceGroup" 
$Zone = New-AzDnsZone -Name "mychild.zone.com" -ResourceGroupName "MyResourceGroup" -ParentZone @($PZone)

此命令在指定的资源组中创建一个名为 mychild.zone.com 的新子 DNS 区域，并将其存储在$Zone变量中。 它还会在父 DNS 区域中添加委派，在 ParentZone 对象中传递 zone.com

参数

-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:AzContext, 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

-ParentZone

要添加委派的父区域的完整名称（没有终止点）。

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

-ParentZoneId

要添加委派的父区域的资源 ID（不带终止点）。

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

-ParentZoneName

要添加委派的父区域的完整名称（没有终止点）。

Type:String
Position:Named
Default value:None
Required:False
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=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

Hashtable

List<T>[[System.String, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

List<T>[[Microsoft.Azure.Management.Internal.Network.Common.IResourceReference, Microsoft.Azure.PowerShell.Clients.Network, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

输出

DnsZone

备注

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