Add-SCVMNetworkGateway
Adiciona um gateway de rede de máquina virtual ao VMM.
Sintaxe
Add-SCVMNetworkGateway
[-VMMServer <ServerConnection>]
-VMNetwork <VMNetwork>
[-RequiresVPN]
[-RequiresNAT]
[-EnableBGP <Boolean>]
[-AutonomousSystemNumber <UInt32>]
-Name <String>
[-Description <String>]
[-RoutingIPSubnet <String>]
[-FabricRole <FabricRole>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Add-SCVMNetworkGateway
[-VMMServer <ServerConnection>]
-VMNetwork <VMNetwork>
-NetworkGateway <NetworkServiceBase>
[-EnableBGP <Boolean>]
[-AutonomousSystemNumber <UInt32>]
-Name <String>
[-Description <String>]
[-RoutingIPSubnet <String>]
[-FabricRole <FabricRole>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Description
O cmdlet Add-SCVMNetworkGateway adiciona um gateway de rede de máquina virtual ao Virtual Machine Manager (VMM).
Exemplos
Exemplo 1: Criar um gateway de rede de máquina virtual
PS C:\> $ContosoNetworkGateway = Get-SCNetworkGateway -Name "ContosoNetworkGateway"
PS C:\> $VmNetworkGateway = Add-SCVMNetworkGateway -Name "VMNetworkGateway" -EnableBGP $True -NetworkGateway $ContosoNetworkGateway -VMNetwork $VmNetwork -AutonomousSystemNumber "1000" -RoutingIPSubnet "10.251.251.0/29"O primeiro comando obtém um gateway de rede chamado ContosoNetworkGateway e o armazena na variável $ContosoNetworkGateway.
O segundo comando cria um gateway de rede de máquina virtual para o gateway no $ContosoNetworkGateway.
Exemplo 2: Criar um gateway de rede de máquina virtual (IPv6)
Observação
Este exemplo é aplicável a partir do VMM 2019 UR2 e posterior.
PS C:\> $ContosoNetworkGateway = Get-SCNetworkGateway -Name "ContosoNetworkGateway"
PS C:\> $VmNetworkGateway = Add-SCVMNetworkGateway -Name "VMNetworkGateway" -EnableBGP $True -NetworkGateway $ContosoNetworkGateway -VMNetwork $VmNetwork -AutonomousSystemNumber "1000" -RoutingIPSubnet "10.251.251.0;FD4A:293D:184F:382C::/64"O primeiro comando obtém um gateway de rede chamado ContosoNetworkGateway e o armazena na variável $ContosoNetworkGateway.
O segundo comando cria um gateway de rede de máquina virtual para o gateway no $ContosoNetworkGateway.
Parâmetros
-AutonomousSystemNumber
Especifica um número de sistema autônomo (ASN).
| Tipo: | UInt32 |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Description
Especifica uma descrição para o gateway de rede da máquina virtual.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-EnableBGP
Indica se o BGP (Border Gateway Protocol) está habilitado.
| Tipo: | Boolean |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-FabricRole
Especifica uma função de malha.
| Tipo: | FabricRole |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-JobVariable
Especifica que o progresso do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Name
Especifica o nome de um objeto do VMM.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-NetworkGateway
Especifica um objeto de gateway de rede.
Para obter um objeto de gateway de rede, use o cmdlet Get-SCNetworkGateway.
| Tipo: | NetworkServiceBase |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-OnBehalfOfUser
Especifica um nome de usuário. Este cmdlet opera em nome do usuário especificado por esse parâmetro.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-OnBehalfOfUserRole
Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole. Este cmdlet opera em nome da função de usuário especificada por esse parâmetro.
| Tipo: | UserRole |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-PROTipID
Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.
| Tipo: | Guid |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-RequiresNAT
Indica que a conexão requer conversão de endereços de rede (NAT).
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-RequiresVPN
Indica que uma rede virtual privada (VPN) é necessária.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-RoutingIPSubnet
Especifica uma sub-rede IP de roteamento para um gateway de rede de máquina virtual.
Observação
A partir de 2019 UR2 e posteriores, os endereços IPV4 e IPV6 separados por ';' podem ser passados para este parâmetro.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-RunAsynchronously
Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-VMMServer
Especifica um objeto de servidor VMM.
| Tipo: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-VMNetwork
Especifica um objeto de rede de máquina virtual.
Para obter um objeto de rede de máquina virtual, use o cmdlet Get-SCVMNetwork.
| Tipo: | VMNetwork |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |