你当前正在访问 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-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

指定网关的 ID 负载均衡器提供程序前端 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, 资源, 管理, 经理, 网络, 网络