Set-AzVirtualNetworkSubnetConfig

模組:: Az.Network Module

更新虛擬網路的子網路組態。

語法

SetByResource (預設值)

Set-AzVirtualNetworkSubnetConfig
    -Name <String>
    -VirtualNetwork <PSVirtualNetwork>
    [-AddressPrefix <String[]>]
    [-IpamPoolPrefixAllocation <PSIpamPoolPrefixAllocation[]>]
    [-NetworkSecurityGroup <PSNetworkSecurityGroup>]
    [-RouteTable <PSRouteTable>]
    [-InputObject <PSNatGateway>]
    [-ServiceEndpoint <String[]>]
    [-NetworkIdentifier <PSResourceId>]
    [-ServiceEndpointConfig <PSServiceEndpoint[]>]
    [-ServiceEndpointPolicy <PSServiceEndpointPolicy[]>]
    [-Delegation <PSDelegation[]>]
    [-PrivateEndpointNetworkPoliciesFlag <String>]
    [-PrivateLinkServiceNetworkPoliciesFlag <String>]
    [-IpAllocation <PSIpAllocation[]>]
    [-DefaultOutboundAccess <Boolean>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SetByResourceId

Set-AzVirtualNetworkSubnetConfig
    -Name <String>
    -VirtualNetwork <PSVirtualNetwork>
    [-AddressPrefix <String[]>]
    [-IpamPoolPrefixAllocation <PSIpamPoolPrefixAllocation[]>]
    [-NetworkSecurityGroupId <String>]
    [-RouteTableId <String>]
    [-ResourceId <String>]
    [-ServiceEndpoint <String[]>]
    [-NetworkIdentifier <PSResourceId>]
    [-ServiceEndpointConfig <PSServiceEndpoint[]>]
    [-ServiceEndpointPolicy <PSServiceEndpointPolicy[]>]
    [-Delegation <PSDelegation[]>]
    [-PrivateEndpointNetworkPoliciesFlag <String>]
    [-PrivateLinkServiceNetworkPoliciesFlag <String>]
    [-IpAllocation <PSIpAllocation[]>]
    [-DefaultOutboundAccess <Boolean>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

Set-AzVirtualNetworkSubnetConfig Cmdlet 會更新虛擬網路的子網路設定。

範例

範例 1：修改子網路的位址前置詞

New-AzResourceGroup -Name TestResourceGroup -Location centralus

$frontendSubnet = New-AzVirtualNetworkSubnetConfig -Name frontendSubnet -AddressPrefix "10.0.1.0/24"

$virtualNetwork = New-AzVirtualNetwork -Name MyVirtualNetwork -ResourceGroupName TestResourceGroup -Location centralus -AddressPrefix "10.0.0.0/16" -Subnet $frontendSubnet

Set-AzVirtualNetworkSubnetConfig -Name frontendSubnet -VirtualNetwork $virtualNetwork -AddressPrefix "10.0.3.0/23"

$virtualNetwork | Set-AzVirtualNetwork

此範例會建立具有一個子網路的虛擬網路。然後是 Set-AzVirtualNetworkSubnetConfig 呼叫來修改子網路的 AddressPrefix。這只會影響虛擬網路的記憶體內表示法。然後呼叫 Set-AzVirtualNetwork 來修改 Azure 中的虛擬網路。

範例 2：將網路安全性群組新增至子網路

New-AzResourceGroup -Name TestResourceGroup -Location centralus

$frontendSubnet = New-AzVirtualNetworkSubnetConfig -Name frontendSubnet -AddressPrefix "10.0.1.0/24"

$virtualNetwork = New-AzVirtualNetwork -Name MyVirtualNetwork -ResourceGroupName TestResourceGroup -Location centralus -AddressPrefix "10.0.0.0/16" -Subnet $frontendSubnet

$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

Set-AzVirtualNetworkSubnetConfig -Name frontendSubnet -VirtualNetwork $virtualNetwork -AddressPrefix "10.0.1.0/24" -NetworkSecurityGroupId $networkSecurityGroup.Id

$virtualNetwork | Set-AzVirtualNetwork

此範例會建立一個資源群組，其中包含一個僅包含一個子網路的虛擬網路。然後，它會建立具有 RDP 流量允許規則的網路安全性群組。 Set-AzVirtualNetworkSubnetConfig Cmdlet 可用來修改前端子網路的記憶體內表示法，使其指向新建立的網路安全性群組。然後呼叫 Set-AzVirtualNetwork Cmdlet，將修改的狀態寫回服務。

範例 3：將 Nat 閘道連接至子網路

$pip = New-AzPublicIpAddress -Name "pip" -ResourceGroupName "natgateway_test" `
   -Location "eastus2" -Sku "Standard" -IdleTimeoutInMinutes 4 -AllocationMethod "static"

$natGateway = New-AzNatGateway -ResourceGroupName "natgateway_test" -Name "nat_gateway" `
   -IdleTimeoutInMinutes 4 -Sku "Standard" -Location "eastus2" -PublicIpAddress $pip

$frontendSubnet = New-AzVirtualNetworkSubnetConfig -Name frontendSubnet -AddressPrefix "10.0.1.0/24"

$virtualNetwork = New-AzVirtualNetwork -Name MyVirtualNetwork -ResourceGroupName TestResourceGroup -Location eastus2 -AddressPrefix "10.0.0.0/16" -Subnet $frontendSubnet

Set-AzVirtualNetworkSubnetConfig -Name frontendSubnet -VirtualNetwork $virtualNetwork -InputObject $natGateway -AddressPrefix "10.0.0.0/16"

$virtualNetwork | Set-AzVirtualNetwork

參數

-AddressPrefix

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

參數屬性

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

參數集

(All)

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

-DefaultOutboundAccess

子網路中所有 VM 的預設輸出連線

參數屬性

類型:	Nullable<T>[Boolean]
預設值:	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

-Delegation

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

參數屬性

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

參數集

(All)

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

-InputObject

指定與子網路組態相關聯的 nat 閘道。

參數屬性

類型:	PSNatGateway
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	NatGateway 閘道

參數集

SetByResource

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

-IpAllocation

指定子網路的 IpAllocations。

參數屬性

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

參數集

(All)

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

-IpamPoolPrefixAllocation

IpamPool 以自動配置子網路位址前置詞。

參數屬性

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

參數集

(All)

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

-Name

指定此 Cmdlet 所設定的子網路設定名稱。

參數屬性

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

參數集

(All)

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

-NetworkIdentifier

ServiceEndpoint 的 NetworkIdentifier 值

參數屬性

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

參數集

(All)

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

-NetworkSecurityGroup

指定 NetworkSecurityGroup 物件。

參數屬性

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

參數集

SetByResource

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

-NetworkSecurityGroupId

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

參數屬性

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

參數集

SetByResourceId

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

-PrivateEndpointNetworkPoliciesFlag

設定為啟用或停用在子網路中的私人端點上套用網路原則。

參數屬性

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

參數集

(All)

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

-PrivateLinkServiceNetworkPoliciesFlag

設定為啟用或停用在子網路中的私人連結服務上套用網路原則。

參數屬性

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

參數集

(All)

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

-ResourceId

指定與子網路組態相關聯的 NAT 閘道資源 ID。

參數屬性

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

參數集

SetByResourceId

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

-RouteTable

指定與網路安全性群組相關聯的路由表物件。

參數屬性

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

參數集

SetByResource

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

-RouteTableId

指定與網路安全群組相關聯之路由表物件的識別碼。

參數屬性

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

參數集

SetByResourceId

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

-ServiceEndpoint

服務端點值

參數屬性

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

參數集

(All)

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

-ServiceEndpointConfig

具有 NetworkIdentifier 值的服務端點

參數屬性

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

參數集

(All)

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

-ServiceEndpointPolicy

服務端點原則

參數屬性

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

參數集

(All)

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

-VirtualNetwork

指定包含子網路組態的 VirtualNetwork 物件。

參數屬性

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

參數集

(All)

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

CommonParameters

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

輸出

PSVirtualNetwork

意見反應

此頁面對您有幫助嗎？

共用方式為

Set-AzVirtualNetworkSubnetConfig

語法

SetByResource (預設值)

SetByResourceId

Description

範例

範例 1：修改子網路的位址前置詞

範例 2：將網路安全性群組新增至子網路

範例 3：將 Nat 閘道連接至子網路

參數

-AddressPrefix

參數屬性

參數集

-DefaultOutboundAccess

參數屬性

參數集

-DefaultProfile

參數屬性

參數集

-Delegation

參數屬性

參數集

-InputObject

參數屬性

參數集

-IpAllocation

參數屬性

參數集

-IpamPoolPrefixAllocation

參數屬性

參數集

-Name

參數屬性

參數集

-NetworkIdentifier

參數屬性

參數集

-NetworkSecurityGroup

參數屬性

參數集

-NetworkSecurityGroupId

參數屬性

參數集

-PrivateEndpointNetworkPoliciesFlag

參數屬性

參數集

-PrivateLinkServiceNetworkPoliciesFlag

參數屬性

參數集

-ResourceId

參數屬性

參數集

-RouteTable

參數屬性

參數集

-RouteTableId

參數屬性

參數集

-ServiceEndpoint

參數屬性

參數集

-ServiceEndpointConfig

參數屬性

參數集

-ServiceEndpointPolicy

參數屬性

參數集

-VirtualNetwork

參數屬性

參數集

CommonParameters

輸入

輸出

相關連結

意見反應