共用方式為


Add-AzureRmVirtualNetworkSubnetConfig

新增子網路組態至虛擬網路。

警告

自 2024 年 2 月 29 日起,AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組,以確保持續支援和更新。

雖然 AzureRM 模組可能仍可運作,但不再維護或支援它,但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引,請參閱我們的 移轉資源

語法

Add-AzureRmVirtualNetworkSubnetConfig
   -Name <String>
   -VirtualNetwork <PSVirtualNetwork>
   -AddressPrefix <System.Collections.Generic.List`1[System.String]>
   [-NetworkSecurityGroup <PSNetworkSecurityGroup>]
   [-RouteTable <PSRouteTable>]
   [-ServiceEndpoint <System.Collections.Generic.List`1[System.String]>]
   [-ServiceEndpointPolicy <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSServiceEndpointPolicy]>]
   [-Delegation <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSDelegation]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzureRmVirtualNetworkSubnetConfig
   -Name <String>
   -VirtualNetwork <PSVirtualNetwork>
   -AddressPrefix <System.Collections.Generic.List`1[System.String]>
   [-NetworkSecurityGroupId <String>]
   [-RouteTableId <String>]
   [-ServiceEndpoint <System.Collections.Generic.List`1[System.String]>]
   [-ServiceEndpointPolicy <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSServiceEndpointPolicy]>]
   [-Delegation <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSDelegation]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Add-AzureRmVirtualNetworkSubnetConfig Cmdlet 會將子網組態新增至現有的 Azure 虛擬網路。

範例

1:將子網新增至現有的虛擬網路

New-AzureRmResourceGroup -Name TestResourceGroup -Location centralus
    $frontendSubnet = New-AzureRmVirtualNetworkSubnetConfig -Name frontendSubnet -AddressPrefix "10.0.1.0/24"
    $virtualNetwork = New-AzureRmVirtualNetwork -Name MyVirtualNetwork -ResourceGroupName TestResourceGroup -Location centralus -AddressPrefix "10.0.0.0/16" -Subnet $frontendSubnet
    Add-AzureRmVirtualNetworkSubnetConfig -Name backendSubnet -VirtualNetwork $virtualNetwork -AddressPrefix "10.0.2.0/24"
    $virtualNetwork | Set-AzureRmVirtualNetwork

此範例會先建立資源群組做為要建立之資源的容器。 然後,它會建立子網組態,並使用它來建立虛擬網路。 接著,Add-AzureRmVirtualNetworkSubnetConfig 會用來將子網新增至虛擬網路的記憶體內部表示法。 Set-AzureRmVirtualNetwork 命令會使用新的子網來更新現有的虛擬網路。

2:將委派新增至要新增至現有虛擬網路的子網

PS C:\> $vnet = Get-AzureRmVirtualNetwork -Name "myVNet" -ResourceGroupName "myResourceGroup"
PS C:\> $delegation = New-AzureRmDelegation -Name "myDelegation" -ServiceName "Microsoft.Sql/servers"
PS C:\> Add-AzureRmVirtualNetworkSubnetConfig -Name "mySubnet" -VirtualNetwork $vnet -AddressPrefix "10.0.2.0/24" -Delegation $delegation | Set-AzureRmVirtualNetwork

此範例會先取得現有的 vnet。 然後,它會在記憶體中建立委派物件。 最後,它會使用新增至 vnet 的委派,建立新的子網。 然後,修改過的組態會傳送至伺服器。

參數

-AddressPrefix

指定子網組態的IP位址範圍。

類型:List<T>[String]
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-DefaultProfile

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

類型:IAzureContextContainer
別名:AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Delegation

有權在此子網上執行作業的服務清單。

類型:List<T>[PSDelegation]
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Name

指定要新增的子網組態名稱。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-NetworkSecurityGroup

指定 NetworkSecurityGroup 物件。 此 Cmdlet 會將虛擬網路子網組態新增至此參數所指定的物件。

類型:PSNetworkSecurityGroup
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-NetworkSecurityGroupId

指定網路安全組的識別碼。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-RouteTable

類型:PSRouteTable
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-RouteTableId

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ServiceEndpoint

服務端點值

類型:List<T>[String]
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ServiceEndpointPolicy

服務端點原則

類型:List<T>[PSServiceEndpointPolicy]
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-VirtualNetwork

指定要 在其中新增子網組態的 VirtualNetwork 物件。

類型:PSVirtualNetwork
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

輸入

PSVirtualNetwork

String

PSNetworkSecurityGroup

PSRouteTable

List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSServiceEndpointPolicy, Microsoft.Azure.Commands.Network, Version=6.7.0.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSDelegation, Microsoft.Azure.Commands.Network, Version=6.7.0.0, Culture=neutral, PublicKeyToken=null]]

輸出

PSVirtualNetwork