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

New-AzDnsZone

创建新的 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 之前进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-DefaultProfile

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

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

-Name

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

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

-ParentZone

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

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

-ParentZoneId

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

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

-ParentZoneName

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

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

-RegistrationVirtualNetwork

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

类型:List<T>[IResourceReference]
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-RegistrationVirtualNetworkId

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

类型:List<T>[String]
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-ResolutionVirtualNetwork

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

类型:List<T>[IResourceReference]
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-ResolutionVirtualNetworkId

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

类型:List<T>[String]
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-ResourceGroupName

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

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

-Tag

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

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

-WhatIf

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

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-ZoneType

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

类型:Nullable<T>[ZoneType]
接受的值:Public, Private
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符: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 不会提示你进行确认。