你当前正在访问 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)

此命令在指定的资源组中创建一个名为 myprivatezone.com 的新专用 DNS区域,其中包含关联的解析虚拟网络 (指定其 ID) ,然后将其存储在$Zone变量中。

示例 3:通过指定虚拟网络对象创建专用 DNS区域

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

此命令在指定的资源组中创建一个名为 myprivatezone.com 的新专用 DNS区域,其中包含由$ResVirtualNetwork变量) 引用的关联解析虚拟网络 (,然后将其存储在$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变量中。 它还在资源组其他 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 区域中添加委派,命名为 zone.com,如在 ParentZone 对象中传递

参数

-Confirm

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

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

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

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

-ParentZone

父区域的完整名称,用于添加委派 (,而无需终止点) 。

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

-ParentZoneId

父区域的资源 ID,用于添加委派 (,而无需终止点) 。

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

-ParentZoneName

父区域的完整名称,用于添加委派 (,而无需终止点) 。

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

-RegistrationVirtualNetwork

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

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

-RegistrationVirtualNetworkId

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

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

-ResolutionVirtualNetwork

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

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

-ResolutionVirtualNetworkId

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

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

-ResourceGroupName

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

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

-Tag

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

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

-WhatIf

显示在此 cmdlet 运行的情况下将会发生什么。 cmdlet 未运行。显示 cmdlet 运行时会发生什么情况。 此 cmdlet 未运行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value: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
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 是否提示你进行确认。 默认情况下,cmdlet 会提示确认$ConfirmPreference Windows PowerShell变量的值是否为中或更低。 如果指定 “确认 ”或 “确认:$True”,则此 cmdlet 会在运行之前提示你进行确认。 如果指定 Confirm:$False,则 cmdlet 不会提示你进行确认。