Set-AzNetworkInterfaceIpConfig

模組:

Az.Network

更新網路介面的IP組態。

語法

Set-AzNetworkInterfaceIpConfig
   -Name <String>
   -NetworkInterface <PSNetworkInterface>
   [-PrivateIpAddressVersion <String>]
   [-PrivateIpAddress <String>]
   [-Primary]
   [-Subnet <PSSubnet>]
   [-PublicIpAddress <PSPublicIpAddress>]
   [-LoadBalancerBackendAddressPool <PSBackendAddressPool[]>]
   [-LoadBalancerInboundNatRule <PSInboundNatRule[]>]
   [-ApplicationGatewayBackendAddressPool <PSApplicationGatewayBackendAddressPool[]>]
   [-ApplicationSecurityGroup <PSApplicationSecurityGroup[]>]
   [-GatewayLoadBalancerId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Set-AzNetworkInterfaceIpConfig
   -Name <String>
   -NetworkInterface <PSNetworkInterface>
   [-PrivateIpAddressVersion <String>]
   [-PrivateIpAddress <String>]
   [-Primary]
   [-SubnetId <String>]
   [-PublicIpAddressId <String>]
   [-LoadBalancerBackendAddressPoolId <String[]>]
   [-LoadBalancerInboundNatRuleId <String[]>]
   [-ApplicationGatewayBackendAddressPoolId <String[]>]
   [-ApplicationSecurityGroupId <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Set-AzNetworkInterfaceIpConfig Cmdlet 會更新網路介面的 IP 組態。

範例

範例 1：變更 IP 組態的 IP 位址

$vnet = Get-AzVirtualNetwork -Name myvnet -ResourceGroupName myrg
$subnet = Get-AzVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet

$nic = Get-AzNetworkInterface -Name nic1 -ResourceGroupName myrg

$nic | Set-AzNetworkInterfaceIpConfig -Name ipconfig1 -PrivateIpAddress 10.0.0.11 -Subnet $subnet -Primary

$nic | Set-AzNetworkInterface

前兩個命令會取得名為 myvnet 的虛擬網路和名為 mysubnet 的子網，並將它分別儲存在變數$vnet和$subnet中。 第三個命令會取得與需要更新之IP組態相關聯的網路介面 nic1。 第三個命令會將主要IP組態ipconfig1的私人IP位址設定為10.0.0.0.11。 最後，最後一個命令會更新網路介面，以確保已成功進行變更。

範例 2：將IP組態與應用程式安全組建立關聯

$vnet = Get-AzVirtualNetwork -Name myvnet -ResourceGroupName myrg
$subnet = Get-AzVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$asg = Get-AzApplicationSecurityGroup -Name myasg -ResourceGroupName myrg

$nic = Get-AzNetworkInterface -Name nic1 -ResourceGroupName myrg

$nic | Set-AzNetworkInterfaceIpConfig -Name ipconfig1 -PrivateIpAddress 10.0.0.11 -Subnet $subnet -ApplicationSecurityGroup $asg -Primary

$nic | Set-AzNetworkInterface

在此範例中，變數$asg包含應用程式安全組的參考。 第四個命令會取得與需要更新之IP組態相關聯的網路介面 nic1。 Set-AzNetworkInterfaceIpConfig 會將主要 IP 組態 ipconfig1 的私人 IP 位址設定為 10.0.0.11，並與擷取的應用程式安全組建立關聯。 最後，最後一個命令會更新網路介面，以確保已成功進行變更。

範例 3：解除與應用程式閘道後端位址池的IP組態關聯

$nic = Get-AzNetworkInterface -Name nic1 -ResourceGroupName myrg

$nic | Set-AzNetworkInterfaceIpConfig -Name ipconfig1 -ApplicationGatewayBackendAddressPool $null

$nic | Set-AzNetworkInterface

Set-AzNetworkInterfaceIpConfig 會將IP組態 ipconfig1 的應用程式閘道後端位址池設定為 null，並與網路介面解除關聯。 最後，最後一個命令會更新網路介面，以確保已成功進行變更。

參數

-ApplicationGatewayBackendAddressPool

指定此網路介面IP組態所屬的應用程式閘道後端位址池參考集合。

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

-ApplicationGatewayBackendAddressPoolId

指定此網路介面IP組態所屬的應用程式閘道後端位址池參考集合。

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

-ApplicationSecurityGroup

指定此網路介面IP組態所屬的應用程式安全組參考集合。

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

-ApplicationSecurityGroupId

指定此網路介面IP組態所屬的應用程式安全組參考集合。

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

-DefaultProfile

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

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

-GatewayLoadBalancerId

指定閘道負載平衡器提供者前端 Ip 組態的識別碼。

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

-LoadBalancerBackendAddressPool

指定此網路介面IP組態所屬的負載平衡器後端位址池參考集合。

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

-LoadBalancerBackendAddressPoolId

指定此網路介面IP組態所屬的負載平衡器後端位址池參考集合。

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

-LoadBalancerInboundNatRule

指定此網路介面IP組態所屬的負載平衡器輸入網路位址轉換 （NAT） 規則參考集合。

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

-LoadBalancerInboundNatRuleId

指定此網路介面IP組態所屬的負載平衡器輸入NAT規則參考集合。

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

-Name

指定此 Cmdlet 設定的網路 IP 組態名稱。

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

-NetworkInterface

指定 NetworkInterface 物件。 這個 Cmdlet 會將網路介面 IP 組態新增至此參數所指定的物件。

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

-Primary

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

-PrivateIpAddress

指定網路介面IP組態的靜態IP位址。

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

-PrivateIpAddressVersion

指定網路介面IP組態的IP位址版本。 此參數可接受的值為：

• IPv4
• IPv6

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

-PublicIpAddress

指定 PublicIPAddress 物件。 此 Cmdlet 會建立公用 IP 位址的參考，以與此網路介面 IP 組態產生關聯。

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

-PublicIpAddressId

此 Cmdlet 會建立公用 IP 位址的參考，以與此網路介面 IP 組態產生關聯。

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

-Subnet

指定 Subnet 物件。 此 Cmdlet 會建立建立此網路介面 IP 組態之子網的參考。

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

-SubnetId

此 Cmdlet 會建立建立此網路介面 IP 組態之子網的參考。

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

輸入

PSNetworkInterface

String[]

PSBackendAddressPool[]

PSInboundNatRule[]

PSApplicationGatewayBackendAddressPool[]

PSApplicationSecurityGroup[]

輸出

PSNetworkInterface

備註

• 關鍵詞：azure、azurerm、arm、resource、management、manager、network、networking

相關連結

• Add-AzNetworkInterfaceIpConfig
• Get-AzNetworkInterfaceIpConfig
• New-AzNetworkInterfaceIpConfig
• Remove-AzNetworkInterfaceIpConfig