你当前正在访问 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 |
输入
Nullable<T>[[Microsoft.Azure.Management.Dns.Models.ZoneType, Microsoft.Azure.Management.Dns, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]
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]]
输出
备注
可以使用 Confirm 参数来控制此 cmdlet 是否提示你进行确认。 默认情况下,如果 $ConfirmPreference Windows PowerShell 变量的值为“中”或“较低”,cmdlet 会提示你进行确认。 如果指定“确认”或“确认:$True”,则此 cmdlet 会在运行之前提示你进行确认。 如果指定 Confirm:$False,cmdlet 不会提示你进行确认。