你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Set-AzNetworkInterfaceIpConfig

更新网络接口的 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>]

说明

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

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