New-AzVirtualNetwork

  • 參考
模組:
Az.Network

建立虛擬網路。

Syntax

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>]
   [-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 命令接著會建立虛擬網路。

參數

-AddressPrefix

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

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

-AsJob

在背景執行 Cmdlet

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BgpCommunity

BGP 社群透過 ExpressRoute 公告。

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

-Confirm

執行 Cmdlet 之前先提示您確認。

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

-DdosProtectionPlanId

與虛擬網路相關聯的 DDoS 保護計劃資源的參考。

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

-DefaultProfile

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

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

-DnsServer

指定子網的 DNS 伺服器。

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

-EdgeZone

{{ Fill EdgeZone Description }}

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

-EnableDdosProtection

參數，表示是否啟用 DDoS 保護。

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

-EnableEncryption

指出虛擬網路上是否啟用加密。 值應該是 true，以在虛擬網路上啟用加密，false 表示停用加密。

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

-EncryptionEnforcementPolicy

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

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

-FlowTimeout

FlowTimeout 會啟用 VM 內部流程的連線追蹤。 此值應介於 4 到 30 分鐘之間（含），以啟用追蹤，或為 Null 來停用追蹤。

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IpAllocation

指定虛擬網路的 IpAllocations。

Type:PSIpAllocation[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Location

指定虛擬網路的區域。

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

-Name

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

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

-ResourceGroupName

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

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

-Subnet

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

Type:PSSubnet[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Tag

哈希表形式的索引鍵/值組。 例如：@{key0=“value0”;key1=$null;key2=“value2”}

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

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

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

輸入

String

String[]

PSSubnet[]

Hashtable

輸出

PSVirtualNetwork