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

Set-AzNetworkInterface

  • 参考
模块:
Az.Network

汇报网络接口。

语法

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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

-NetworkInterface

指定一个网络接口对象，该对象表示应设置网络接口的状态。

Type:PSNetworkInterface
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

输入

PSNetworkInterface

输出

PSNetworkInterface