你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Set-AzNetworkInterfaceIpConfig
汇报网络接口的 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>] 说明
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-AzNetworkInterfaceSet-AzNetworkInterfaceIpConfig 将 IP 配置 ipconfig1 的应用程序网关后端地址池设置为 null，并与网络接口取消关联。 最后，最后一个命令更新网络接口，确保更改成功。
参数
-ApplicationGatewayBackendAddressPool
指定此网络接口 IP 配置所属的应用程序网关后端地址池引用的集合。
| Type: | PSApplicationGatewayBackendAddressPool[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ApplicationGatewayBackendAddressPoolId
指定此网络接口 IP 配置所属的应用程序网关后端地址池引用的集合。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ApplicationSecurityGroup
指定此网络接口 IP 配置所属的应用程序安全组引用的集合。
| Type: | PSApplicationSecurityGroup[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ApplicationSecurityGroupId
指定此网络接口 IP 配置所属的应用程序安全组引用的集合。
| 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 |
-GatewayLoadBalancerId
指定网关的 ID 负载均衡器提供程序前端 Ip 配置。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-LoadBalancerBackendAddressPool
指定此网络接口 IP 配置所属的负载均衡器后端地址池引用的集合。
| Type: | PSBackendAddressPool[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-LoadBalancerBackendAddressPoolId
指定此网络接口 IP 配置所属的负载均衡器后端地址池引用的集合。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-LoadBalancerInboundNatRule
指定此网络接口 IP 配置所属的负载均衡器入站网络地址转换（NAT）规则引用的集合。
| Type: | PSInboundNatRule[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-LoadBalancerInboundNatRuleId
指定此网络接口 IP 配置所属的负载均衡器入站 NAT 规则引用的集合。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
指定此 cmdlet 为其设置的网络 IP 配置的名称。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NetworkInterface
指定 NetworkInterface 对象。 此 cmdlet 将网络接口 IP 配置添加到此参数指定的对象。
| Type: | PSNetworkInterface |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Primary
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PrivateIpAddress
指定网络接口 IP 配置的静态 IP 地址。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PrivateIpAddressVersion
指定网络接口 IP 配置的 IP 地址版本。 此参数的可接受值为：
- IPv4
- IPv6
| Type: | String |
| Accepted values: | IPv4, IPv6 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PublicIpAddress
指定 PublicIPAddress 对象。 此 cmdlet 创建对公共 IP 地址的引用，以与此网络接口 IP 配置相关联。
| Type: | PSPublicIpAddress |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PublicIpAddressId
此 cmdlet 创建对公共 IP 地址的引用，以与此网络接口 IP 配置相关联。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Subnet
指定 Subnet 对象。 此 cmdlet 创建对此网络接口 IP 配置的子网的引用。
| Type: | PSSubnet |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SubnetId
此 cmdlet 创建对此网络接口 IP 配置的子网的引用。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
输入
String[]
PSApplicationGatewayBackendAddressPool[]
输出
备注
- 关键字：azure， azurerm， arm， 资源， 管理， 经理， 网络， 网络
相关链接
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈