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

Set-AzureIPForwarding

启用或禁用 IP 转发。

注意

本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧式 Azure 资源。 创建新资源时,建议不要使用旧的 PowerShell 模块,因为计划将停用 ASM。 有关详细信息,请参阅 Azure Service Manager 停用

Az PowerShell 模块是建议用于管理 PowerShell 的 Azure 资源管理器 (ARM) 资源的 PowerShell 模块。

语法

Set-AzureIPForwarding
   -VM <PersistentVMRoleContext>
   -ServiceName <String>
   [-NetworkInterfaceName <String>]
   [-Enable]
   [-PassThru]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Set-AzureIPForwarding
   -VM <PersistentVMRoleContext>
   -ServiceName <String>
   [-NetworkInterfaceName <String>]
   [-Disable]
   [-PassThru]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Set-AzureIPForwarding
   -ServiceName <String>
   [-Slot <String>]
   -RoleName <String>
   [-NetworkInterfaceName <String>]
   [-Enable]
   [-PassThru]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Set-AzureIPForwarding
   -ServiceName <String>
   [-Slot <String>]
   -RoleName <String>
   [-NetworkInterfaceName <String>]
   [-Disable]
   [-PassThru]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

说明

Set-AzureIPForwarding cmdlet 启用或禁用虚拟机的 IP 转发、平台即服务角色或属于虚拟机或 PaaS 角色的网络适配器。

示例

示例 1:为虚拟机启用 IP 转发

PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "ContosoVM06" | Set-AzureIPForwarding -Enable

此命令获取名为 ContosoService 的服务的名为 ContosoVM06 的虚拟机,并将该虚拟机对象传递给当前 cmdlet。 当前 cmdlet 为该虚拟机启用 IP 转发。

示例 2:禁用虚拟机的 IP 转发

PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "ContosoVM06" | Set-AzureIPForwarding -Disable

此命令获取名为 ContosoService 的服务的名为 ContosoVM06 的虚拟机,并将该虚拟机对象传递给当前 cmdlet。 当前 cmdlet 禁用该虚拟机的 IP 转发。

参数

-Disable

指示此 cmdlet 禁用 IP 转发。

类型:SwitchParameter
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Enable

指示此 cmdlet 启用 IP 转发。

类型:SwitchParameter
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-NetworkInterfaceName

指定此 cmdlet 设置 IP 转发的网络适配器的名称。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-PassThru

返回一个代表你所处理的项目的对象。 默认情况下,此 cmdlet 将不产生任何输出。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Profile

指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件,此 cmdlet 将从本地默认配置文件中读取。

类型:AzureSMProfile
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RoleName

指定此 cmdlet 设置 IP 转发的 PaaS 角色的名称。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-ServiceName

指定云服务的名称。 PaaS 角色属于此参数指定的服务。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Slot

指定 PaaS 槽。 此 cmdlet 为其设置转发的 PaaS 角色具有此参数指定的槽。 有效值为:

  • 生产
  • 过渡

默认值为“生产”。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-VM

指定此 cmdlet 设置 IP 转发的虚拟机对象。

类型:PersistentVMRoleContext
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

输出

Boolean