你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
New-AzVirtualNetwork
创建虚拟网络。
语法
New-AzVirtualNetwork
-Name <String>
-ResourceGroupName <String>
-Location <String>
-AddressPrefix <String[]>
[-DnsServer <String[]>]
[-FlowTimeout <Int32>]
[-Subnet <PSSubnet[]>]
[-BgpCommunity <String>]
[-EnableEncryption <String>]
[-EncryptionEnforcementPolicy <String>]
[-Tag <Hashtable>]
[-EnableDdosProtection]
[-DdosProtectionPlanId <String>]
[-IpAllocation <PSIpAllocation[]>]
[-EdgeZone <String>]
[-PrivateEndpointVNetPoliciesValue <String>]
[-Force]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
New-AzVirtualNetwork cmdlet 创建 Azure 虚拟网络。
示例
示例 1:创建包含两个子网的虚拟网络
New-AzResourceGroup -Name TestResourceGroup -Location centralus
$frontendSubnet = New-AzVirtualNetworkSubnetConfig -Name frontendSubnet -AddressPrefix "10.0.1.0/24"
$backendSubnet = New-AzVirtualNetworkSubnetConfig -Name backendSubnet -AddressPrefix "10.0.2.0/24"
New-AzVirtualNetwork -Name MyVirtualNetwork -ResourceGroupName TestResourceGroup -Location centralus -AddressPrefix "10.0.0.0/16" -Subnet $frontendSubnet,$backendSubnet
此示例创建包含两个子网的虚拟网络。 首先,在中心区域中创建新的资源组。 然后,该示例创建两个子网的内存中表示形式。 New-AzVirtualNetworkSubnetConfig cmdlet 不会在服务器端创建任何子网。 有一个名为 frontendSubnet 的子网和一个名为 backendSubnet 的子网。 然后,New-AzVirtualNetwork cmdlet 使用 CIDR 10.0.0.0/16 作为地址前缀和两个子网创建虚拟网络。
示例 2:使用 DNS 设置创建虚拟网络
New-AzResourceGroup -Name TestResourceGroup -Location centralus
$frontendSubnet = New-AzVirtualNetworkSubnetConfig -Name frontendSubnet -AddressPrefix "10.0.1.0/24"
$backendSubnet = New-AzVirtualNetworkSubnetConfig -Name backendSubnet -AddressPrefix "10.0.2.0/24"
New-AzVirtualNetwork -Name MyVirtualNetwork -ResourceGroupName TestResourceGroup -Location centralus -AddressPrefix "10.0.0.0/16" -Subnet $frontendSubnet,$backendSubnet -DnsServer 10.0.1.5,10.0.1.6
此示例创建一个包含两个子网和两个 DNS 服务器的虚拟网络。 在虚拟网络上指定 DNS 服务器的结果是,部署到此虚拟网络的 NIC/VM 会继承这些 DNS 服务器作为默认值。 可以通过 NIC 级别设置覆盖每个 NIC 的默认值。 如果未在 VNET 上指定 DNS 服务器,并且 NIC 上没有 DNS 服务器,则默认的 Azure DNS 服务器用于 DNS 解析。
示例 3:创建包含引用网络安全组的子网的虚拟网络
New-AzResourceGroup -Name TestResourceGroup -Location centralus
$rdpRule = New-AzNetworkSecurityRuleConfig -Name rdp-rule -Description "Allow RDP" -Access Allow -Protocol Tcp -Direction Inbound -Priority 100 -SourceAddressPrefix Internet -SourcePortRange * -DestinationAddressPrefix * -DestinationPortRange 3389
$networkSecurityGroup = New-AzNetworkSecurityGroup -ResourceGroupName TestResourceGroup -Location centralus -Name "NSG-FrontEnd" -SecurityRules $rdpRule
$frontendSubnet = New-AzVirtualNetworkSubnetConfig -Name frontendSubnet -AddressPrefix "10.0.1.0/24" -NetworkSecurityGroup $networkSecurityGroup
$backendSubnet = New-AzVirtualNetworkSubnetConfig -Name backendSubnet -AddressPrefix "10.0.2.0/24" -NetworkSecurityGroup $networkSecurityGroup
New-AzVirtualNetwork -Name MyVirtualNetwork -ResourceGroupName TestResourceGroup -Location centralus -AddressPrefix "10.0.0.0/16" -Subnet $frontendSubnet,$backendSubnet
此示例创建包含引用网络安全组的子网的虚拟网络。 首先,该示例将资源组创建为将要创建的资源的容器。 然后,将创建允许入站 RDP 访问的网络安全组,但否则会强制实施默认网络安全组规则。 然后,New-AzVirtualNetworkSubnetConfig cmdlet 会创建两个子网的内存中表示形式,这些子网引用已创建的网络安全组。 然后,New-AzVirtualNetwork 命令创建虚拟网络。
参数
-AddressPrefix
指定虚拟网络的 IP 地址范围。
类型: | String[] |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-AsJob
在后台运行 cmdlet
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-BgpCommunity
通过 ExpressRoute 播发的 BGP 社区。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
类型: | SwitchParameter |
别名: | cf |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-DdosProtectionPlanId
引用与虚拟网络关联的 DDoS 保护计划资源。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
类型: | IAzureContextContainer |
别名: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-DnsServer
指定子网的 DNS 服务器。
类型: | String[] |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-EdgeZone
{{ Fill EdgeZone Description }}
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-EnableDdosProtection
一个开关参数,表示是否启用了 DDoS 保护。
类型: | SwitchParameter |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-EnableEncryption
指示是否在虚拟网络上启用加密。 若要在虚拟网络上启用加密,该值应为 true,否则为 false 以禁用加密。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-EncryptionEnforcementPolicy
设置 Encryption EnforcementPolicy。 应允许 AllowUnencrypted 允许在加密虚拟网络中没有加密功能的 VM,或者 dropUnencrypted 禁用任何 VM,而无需将加密功能添加到加密的虚拟网络中。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-FlowTimeout
FlowTimeout 为 VM 内部流启用连接跟踪。 该值应介于 4 到 30 分钟(含)之间,以启用跟踪,或为 null 以禁用跟踪。
类型: | Nullable<T>[Int32] |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-Force
强制运行命令而不要求用户确认。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-IpAllocation
指定虚拟网络的 IpAllocations。
类型: | PSIpAllocation[] |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-Location
指定虚拟网络的区域。
类型: | String |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-Name
指定此 cmdlet 创建的虚拟网络的名称。
类型: | String |
别名: | ResourceName |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-PrivateEndpointVNetPoliciesValue
虚拟网络的 PrivateEndpointVNetPolicies
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-ResourceGroupName
指定要包含虚拟网络的资源组的名称。
类型: | String |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-Subnet
指定要与虚拟网络关联的子网列表。
类型: | PSSubnet[] |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-Tag
以哈希表的形式进行键值对。 例如:@{key0=“value0”;key1=$null;key2=“value2”}
类型: | Hashtable |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-WhatIf
显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。
类型: | SwitchParameter |
别名: | wi |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
输入
String[]
PSSubnet[]