Partilhar via


Set-AzureIPForwarding

Habilita ou desabilita o encaminhamento de IP.

Nota

Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo do PowerShell herdado não é recomendado ao criar novos recursos, uma vez que o ASM está agendado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo PowerShell recomendado para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

Sintaxe

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>]

Description

O cmdlet Set-AzureIPForwarding habilita ou desabilita o encaminhamento de IP para uma máquina virtual, para uma função de plataforma como serviço (PaaS) ou um adaptador de rede que pertence a uma máquina virtual ou função PaaS.

Exemplos

Exemplo 1: Habilitar o encaminhamento de IP para uma máquina virtual

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

Este comando obtém uma máquina virtual chamada ContosoVM06 para o serviço chamado ContosoService e passa esse objeto de máquina virtual para o cmdlet atual. O cmdlet atual permite o encaminhamento de IP para essa máquina virtual.

Exemplo 2: Desabilitar o encaminhamento de IP para uma máquina virtual

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

Este comando obtém uma máquina virtual chamada ContosoVM06 para o serviço chamado ContosoService e passa esse objeto de máquina virtual para o cmdlet atual. O cmdlet atual desabilita o encaminhamento de IP para essa máquina virtual.

Parâmetros

-Disable

Indica que esse cmdlet desabilita o encaminhamento de IP.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Enable

Indica que esse cmdlet habilita o encaminhamento de IP.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-NetworkInterfaceName

Especifica o nome do adaptador de rede no qual este cmdlet define o encaminhamento de IP.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PassThru

Retorna um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet não gera nenhuma saída.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Profile

Especifica o perfil do Azure a partir do qual este cmdlet é lido. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.

Tipo:AzureSMProfile
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RoleName

Especifica o nome de uma função PaaS na qual esse cmdlet define o encaminhamento de IP.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ServiceName

Especifica o nome de um serviço de nuvem. A função PaaS pertence ao serviço especificado por esse parâmetro.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Slot

Especifica um slot PaaS. A função PaaS para a qual este cmdlet define o encaminhamento tem o slot especificado por esse parâmetro. Os valores válidos são:

  • Produção
  • Processo de teste

O valor padrão é Production.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VM

Especifica o objeto de máquina virtual no qual este cmdlet define o encaminhamento de IP.

Tipo:PersistentVMRoleContext
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Saídas

Boolean