你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Set-AzNetworkInterface
更新网络接口。
语法
Set-AzNetworkInterface
-NetworkInterface <PSNetworkInterface>
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] 说明
Set-AzNetworkInterface 更新网络接口。
示例
示例 1：配置网络接口
$Nic = Get-AzNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$Nic.IpConfigurations[0].PrivateIpAddress = "10.0.1.20"
$Nic.IpConfigurations[0].PrivateIpAllocationMethod = "Static"
$Nic.Tag = @{Name = "Name"; Value = "Value"}
Set-AzNetworkInterface -NetworkInterface $Nic此示例配置网络接口。 第一个命令在资源组 ResourceGroup1 中获取名为 NetworkInterface1 的网络接口。 第二个命令设置 IP 配置的专用 IP 地址。 第三个命令将专用 IP 分配方法设置为 Static。 第四个命令在网络接口上设置标记。 第五个命令使用存储在$Nic变量中的信息来设置网络接口。
示例 2：更改网络接口上的 DNS 设置
$nic = Get-AzNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$nic.DnsSettings.DnsServers.Add("192.168.1.100")
$nic | Set-AzNetworkInterface第一个命令获取资源组 ResourceGroup1 中存在的名为 NetworkInterface1 的网络接口。 第二个命令将 DNS 服务器 192.168.1.100 添加到此接口。 第三个命令将这些更改应用于网络接口。 若要删除 DNS 服务器，请遵循上面列出的命令，但替换“。使用“添加”。第二个命令中的“删除”。
示例 3：在网络接口上启用 IP 转发
$nic = Get-AzNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$nic.EnableIPForwarding = 1
$nic | Set-AzNetworkInterface第一个命令获取名为 NetworkInterface1 的现有网络接口，并将其存储在$nic变量中。 第二个命令将 IP 转发值更改为 true。 最后，第三个命令将更改应用于网络接口。 若要在网络接口上禁用 IP 转发，请遵循示例示例，但请务必将第二个命令更改为“$nic。EnableIPForwarding = 0”。
示例 4：更改网络接口的子网
$nic = Get-AzNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$vnet = Get-AzVirtualNetwork -Name VNet1 -ResourceGroupName crosssubcrossversionpeering
$subnet2 = Get-AzVirtualNetworkSubnetConfig -Name Subnet2 -VirtualNetwork $vnet
$nic.IpConfigurations[0].Subnet.Id = $subnet2.Id
$nic | Set-AzNetworkInterface第一个命令获取网络接口 NetworkInterface1 并将其存储在$nic变量中。 第二个命令获取与网络接口要与之关联的子网关联的虚拟网络。 第二个命令获取子网并将其存储在 $subnet 2 变量中。 第三个命令将网络接口的主专用 IP 地址与新子网相关联。 最后，最后一个命令在网络接口上应用了这些更改。
注意
IP 配置必须是动态的，然后才能更改子网。 如果有静态 IP 配置，请在继续操作之前更改为动态。
注意
如果网络接口具有多个 IP 配置，则在执行最终 Set-AzNetworkInterface 命令之前，必须为所有这些 IP 配置执行第四个命令。 这可以像第四个命令一样完成，但通过将“0”替换为相应的数字。 如果网络接口具有 N 个 IP 配置，则这些命令中的 N-1 必须存在。
示例 5：将网络安全组关联/取消关联到网络接口
$nic = Get-AzNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$nsg = Get-AzNetworkSecurityGroup -ResourceGroupName "ResourceGroup1" -Name "MyNSG"
$nic.NetworkSecurityGroup = $nsg
$nic | Set-AzNetworkInterface第一个命令获取名为 NetworkInterface1 的现有网络接口，并将其存储在$nic变量中。 第二个命令获取名为 MyNSG 的现有网络安全组，并将其存储在$nsg变量中。 第三个命令将$nsg分配给$nic。 最后，第四个命令将更改应用于网络接口。 若要从网络接口取消关联网络安全组，请将第三个命令中的$nsg替换为$null。
参数
-AsJob
在后台运行 cmdlet
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
| 类型: | IAzureContextContainer |
| 别名: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-NetworkInterface
指定一个网络接口对象，该对象表示应设置网络接口的状态。
| 类型: | PSNetworkInterface |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
