Set-AzNetworkInterfaceIpConfig

模組:

Az.Network Module

更新網路介面的 IP 組態。

語法

SetByResource (預設值)

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>]

SetByResourceId

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.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[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SetByResource

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

-ApplicationGatewayBackendAddressPoolId

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

參數屬性

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

參數集

SetByResourceId

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

-ApplicationSecurityGroup

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

參數屬性

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

參數集

SetByResource

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

-ApplicationSecurityGroupId

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

參數屬性

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

參數集

SetByResourceId

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

-DefaultProfile

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

參數屬性

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

參數集

(All)

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

-GatewayLoadBalancerId

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

參數屬性

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

參數集

SetByResource

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

-LoadBalancerBackendAddressPool

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

參數屬性

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

參數集

SetByResource

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

-LoadBalancerBackendAddressPoolId

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

參數屬性

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

參數集

SetByResourceId

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

-LoadBalancerInboundNatRule

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

參數屬性

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

參數集

SetByResource

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

-LoadBalancerInboundNatRuleId

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

參數屬性

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

參數集

SetByResourceId

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

-Name

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

參數屬性

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

參數集

(All)

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

-NetworkInterface

指定 NetworkInterface 物件。 此 Cmdlet 會將網路介面 IP 設定新增至此參數指定的物件。

參數屬性

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

參數集

(All)

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

-Primary

Set-AzNetworkInterfaceIpConfig Cmdlet 會更新網路介面的 IP 設定。

參數屬性

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

參數集

(All)

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

-PrivateIpAddress

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

參數屬性

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

參數集

(All)

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

-PrivateIpAddressVersion

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

• IPv4
• IPv6

參數屬性

類型:	String
預設值:	None
接受的值:	IPv4, IPv6
支援萬用字元:	False
不要顯示:	False

參數集

(All)

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

-PublicIpAddress

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

參數屬性

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

參數集

SetByResource

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

-PublicIpAddressId

此 Cmdlet 會建立公用 IP 位址的參考，以與此網路介面 IP 設定相關聯。

參數屬性

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

參數集

SetByResourceId

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

-Subnet

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

參數屬性

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

參數集

SetByResource

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

-SubnetId

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

參數屬性

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

參數集

SetByResourceId

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

CommonParameters

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

輸入

PSNetworkInterface

String

PSBackendAddressPool

PSInboundNatRule

PSApplicationGatewayBackendAddressPool

PSApplicationSecurityGroup

輸出

PSNetworkInterface

備註

• 關鍵詞：azure、azurerm、arm、資源、管理、管理器、網絡、網絡

相關連結

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