Set-AzNetworkInterfaceIpConfig
语法
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>]
说明
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 配置所属的应用程序网关后端地址池引用的集合。
参数属性
参数集
SetByResource
Position: Named
必需: False
来自管道的值: False
来自管道的值(按属性名称): True
来自剩余参数的值: False
-ApplicationGatewayBackendAddressPoolId
指定此网络接口 IP 配置所属的应用程序网关后端地址池引用的集合。
参数属性
类型: String [ ]
默认值: None
支持通配符: False
不显示: False
参数集
SetByResourceId
Position: Named
必需: False
来自管道的值: False
来自管道的值(按属性名称): True
来自剩余参数的值: False
-ApplicationSecurityGroup
指定此网络接口 IP 配置所属的应用程序安全组引用的集合。
参数属性
参数集
SetByResource
Position: Named
必需: False
来自管道的值: False
来自管道的值(按属性名称): True
来自剩余参数的值: False
-ApplicationSecurityGroupId
指定此网络接口 IP 配置所属的应用程序安全组引用的集合。
参数属性
类型: String [ ]
默认值: None
支持通配符: False
不显示: False
参数集
SetByResourceId
Position: Named
必需: False
来自管道的值: False
来自管道的值(按属性名称): True
来自剩余参数的值: False
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
参数属性
参数集
(All)
Position: Named
必需: False
来自管道的值: False
来自管道的值(按属性名称): False
来自剩余参数的值: False
-GatewayLoadBalancerId
指定网关的 ID 负载均衡器提供程序前端 Ip 配置。
参数属性
类型: String
默认值: None
支持通配符: False
不显示: False
参数集
SetByResource
Position: Named
必需: False
来自管道的值: False
来自管道的值(按属性名称): True
来自剩余参数的值: False
-LoadBalancerBackendAddressPool
指定此网络接口 IP 配置所属的负载均衡器后端地址池引用的集合。
参数属性
参数集
SetByResource
Position: Named
必需: False
来自管道的值: False
来自管道的值(按属性名称): True
来自剩余参数的值: False
-LoadBalancerBackendAddressPoolId
指定此网络接口 IP 配置所属的负载均衡器后端地址池引用的集合。
参数属性
类型: String [ ]
默认值: None
支持通配符: False
不显示: False
参数集
SetByResourceId
Position: Named
必需: False
来自管道的值: False
来自管道的值(按属性名称): True
来自剩余参数的值: False
-LoadBalancerInboundNatRule
指定此网络接口 IP 配置所属的负载均衡器入站网络地址转换(NAT)规则引用的集合。
参数属性
参数集
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 配置添加到此参数指定的对象。
参数属性
参数集
(All)
Position: Named
必需: True
来自管道的值: True
来自管道的值(按属性名称): False
来自剩余参数的值: False
-Primary
Set-AzNetworkInterfaceIpConfig cmdlet 更新网络接口的 IP 配置。
参数属性
参数集
(All)
Position: Named
必需: False
来自管道的值: False
来自管道的值(按属性名称): False
来自剩余参数的值: False
-PrivateIpAddress
指定网络接口 IP 配置的静态 IP 地址。
参数属性
类型: String
默认值: None
支持通配符: False
不显示: False
参数集
(All)
Position: Named
必需: False
来自管道的值: False
来自管道的值(按属性名称): False
来自剩余参数的值: False
-PrivateIpAddressVersion
指定网络接口 IP 配置的 IP 地址版本。
此参数的可接受值为:
参数属性
类型: String
默认值: None
接受的值: IPv4, IPv6
支持通配符: False
不显示: False
参数集
(All)
Position: Named
必需: False
来自管道的值: False
来自管道的值(按属性名称): False
来自剩余参数的值: False
-PublicIpAddress
指定 PublicIPAddress 对象。
此 cmdlet 创建对公共 IP 地址的引用,以与此网络接口 IP 配置相关联。
参数属性
参数集
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 。
输出
备注
关键字:azure, azurerm, arm, 资源, 管理, 经理, 网络, 网络