New-AzVirtualNetwork

模組:: Az.Network Module

建立虛擬網路。

語法

Default (預設值)

New-AzVirtualNetwork
    -Name <String>
    -ResourceGroupName <String>
    -Location <String>
    [-AddressPrefix <String[]>]
    [-IpamPoolPrefixAllocation <PSIpamPoolPrefixAllocation[]>]
    [-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>]

Description

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

此範例會建立具有兩個子網路的虛擬網路。首先，會在 centralus 區域中建立新的資源群組。然後，此範例會建立兩個子網路的記憶體內表示法。 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 命令會建立虛擬網路。

範例 4：建立具有 IPAM 集區的虛擬網路，以自動配置位址前置詞

New-AzNetworkManagerIpamPool -ResourceGroupName "testRG" -NetworkManagerName "testNM" -Name "testIpamPool" -Location "centralus" -AddressPrefix @("10.0.0.0/16")
$ipamPool = Get-AzNetworkManagerIpamPool -ResourceGroupName "testRG" -NetworkManagerName "testNM" -Name "testIpamPool"
$ipamPoolPrefixAllocation = [PSCustomObject]@{
     Id = $ipamPool.Id
     NumberOfIpAddresses = "256"
 }
$subnet = New-AzVirtualNetworkSubnetConfig -Name "testSubnet" -IpamPoolPrefixAllocation $ipamPoolPrefixAllocation
New-AzVirtualNetwork -Name "testVnet" -ResourceGroupName "testRG" -Location "centralus" -Subnet $subnet -IpamPoolPrefixAllocation $ipamPoolPrefixAllocation

此範例會建立具有 IPAM （IP 位址管理）集區的虛擬網路，以自動配置位址前置詞。首先，在 centralus 區域的 testRG 資源群組和 testNM 網路管理員中建立名為 testIpamPool 的 IPAM 集區，位址前綴為 10.0.0.0/16。 Get-AzNetworkManagerIpamPool Cmdlet 會擷取剛建立的 IPAM 集區。接下來，會建立代表 IPAM 集區前置詞配置的自訂物件。此物件包含 IPAM 集區的識別碼和要配置的 NumberOfIpAddresses。 New-AzVirtualNetworkSubnetConfig Cmdlet 會建立名為 testSubnet 的子網，設定為使用 IPAM 集區前置詞配置物件。最後，New-AzVirtualNetwork Cmdlet 會在 testRG 資源群組和 centralus 位置中建立名為 testVnet 的虛擬網路。虛擬網路包含上一個步驟中建立的子網，並使用 IPAM 集區前置詞配置進行位址前置詞配置。

參數

-AddressPrefix

指定虛擬網路的 IP 位址範圍。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-AsJob

在背景執行 Cmdlet

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-BgpCommunity

BGP 社群透過 ExpressRoute 公告。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	參見

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DdosProtectionPlanId

與虛擬網路相關聯的 DDoS 防護方案資源的參考。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

參數屬性

類型:	IAzureContextContainer
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	AzContext, AzureRmContext, AzureCredential

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DnsServer

指定子網路的 DNS 伺服器。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-EdgeZone

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-EnableDdosProtection

表示是否啟用 DDoS 防護的參數。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-EnableEncryption

指出虛擬網路上是否啟用加密。值應該為 true 才能在虛擬網路上啟用加密，false 才能停用加密。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-EncryptionEnforcementPolicy

設定 Encryption EnforcementPolicy。此值應該是 allowUnencrypted，以允許加密虛擬網路內沒有加密功能的 VM，或 dropUnencrypted 以停用任何沒有加密功能的 VM 新增至加密的虛擬網路。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-FlowTimeout

FlowTimeout 會啟用虛擬機器內流量的連線追蹤。值應該介於 4 到 30 分鐘（含）之間，才能啟用追蹤，或 null 才能停用追蹤。

參數屬性

類型:	Nullable<T>[Int32]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-Force

強制命令執行，而不要求使用者確認。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-IpAllocation

指定虛擬網路的 IpAllocations。

參數屬性

類型:	PSIpAllocation[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-IpamPoolPrefixAllocation

指定要自動配置虛擬網路位址前置詞的 PSIpamPoolPrefixAllocation 物件清單。

參數屬性

類型:	PSIpamPoolPrefixAllocation[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-Location

指定虛擬網路的區域。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-Name

指定此 Cmdlet 所建立之虛擬網路名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	資源名稱

參數集

(All)

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-PrivateEndpointVNetPoliciesValue

虛擬網路的 PrivateEndpointVNetPolicies

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-ResourceGroupName

指定要包含虛擬網路的資源群組名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-Subnet

指定要與虛擬網路相關聯的子網路清單。

參數屬性

類型:	PSSubnet[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-Tag

雜湊表形式的鍵值對。例如：@{key0=“value0”;key1=$null;key2=“值2”}

參數屬性

類型:	Hashtable
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。指令未執行。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	威斯康辛

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。如需詳細資訊，請參閱 about_CommonParameters。

輸出

PSVirtualNetwork

意見反應

此頁面對您有幫助嗎？

共用方式為

New-AzVirtualNetwork

語法

Default (預設值)

Description

範例

範例 1：建立具有兩個子網路的虛擬網路

範例 2：使用 DNS 設定建立虛擬網路

範例 3：使用參考網路安全性群組的子網路建立虛擬網路

範例 4：建立具有 IPAM 集區的虛擬網路，以自動配置位址前置詞

參數

-AddressPrefix

參數屬性

參數集

-AsJob

參數屬性

參數集

-BgpCommunity

參數屬性

參數集

-Confirm

參數屬性

參數集

-DdosProtectionPlanId

參數屬性

參數集

-DefaultProfile

參數屬性

參數集

-DnsServer

參數屬性

參數集

-EdgeZone

參數屬性

參數集

-EnableDdosProtection

參數屬性

參數集

-EnableEncryption

參數屬性

參數集

-EncryptionEnforcementPolicy

參數屬性

參數集

-FlowTimeout

參數屬性

參數集

-Force

參數屬性

參數集

-IpAllocation

參數屬性

參數集

-IpamPoolPrefixAllocation

參數屬性

參數集

-Location

參數屬性

參數集

-Name

參數屬性

參數集

-PrivateEndpointVNetPoliciesValue

參數屬性

參數集

-ResourceGroupName

參數屬性

參數集

-Subnet

參數屬性

參數集

-Tag

參數屬性

參數集

-WhatIf

參數屬性

參數集

CommonParameters

輸入

String