New-SCVirtualNetworkAdapter
Cria um adaptador de rede virtual em uma máquina virtual, modelo de máquina virtual ou perfil de hardware usado no VMM.
Sintaxe
New-SCVirtualNetworkAdapter
[-IPv4AddressType <EthernetAddressType>]
[-IPv6AddressType <EthernetAddressType>]
[-EnableMACAddressSpoofing <Boolean>]
[-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
[-EnableVMNetworkOptimization <Boolean>]
[-VMNetwork <VMNetwork>]
[-PortClassification <PortClassification>]
[-VMSubnet <VMSubnet>]
[-VLanEnabled <Boolean>]
[-VLanID <UInt16>]
[-AdapterFlags <VirtualNetworkAdapterFlags>]
-VM <VM>
[[-VirtualNetwork] <String>]
[-MACAddress <String>]
[-MACAddressType <String>]
[-NoConnection]
[-Synthetic]
[-LogicalNetwork <LogicalNetwork>]
[-NoVMNetwork]
[-VMwarePortGroup <String>]
[-NetworkLocation <String>]
[-NetworkTag <String>]
[-PortACL <PortACL>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] New-SCVirtualNetworkAdapter
[-VMMServer <ServerConnection>]
[-IPv4AddressType <EthernetAddressType>]
[-IPv6AddressType <EthernetAddressType>]
[-EnableMACAddressSpoofing <Boolean>]
[-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
[-EnableVMNetworkOptimization <Boolean>]
[-VMNetwork <VMNetwork>]
[-PortClassification <PortClassification>]
[-VMSubnet <VMSubnet>]
[-VLanEnabled <Boolean>]
[-VLanID <UInt16>]
[-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
[-AdapterFlags <VirtualNetworkAdapterFlags>]
[-VMHost <Host>]
[-LogicalSwitch <LogicalSwitch>]
-JobGroup <Guid>
[[-VirtualNetwork] <String>]
[-MACAddress <String>]
[-MACAddressType <String>]
[-NoConnection]
[-Synthetic]
[-LogicalNetwork <LogicalNetwork>]
[-VMNetworkServiceSetting <String>]
[-NoVMNetwork]
[-VMwarePortGroup <String>]
[-NetworkLocation <String>]
[-NetworkTag <String>]
[-DevicePropertiesAdapterName <String>]
[-PortACL <PortACL>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] New-SCVirtualNetworkAdapter
[-IPv4AddressType <EthernetAddressType>]
[-IPv6AddressType <EthernetAddressType>]
[-EnableMACAddressSpoofing <Boolean>]
[-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
[-EnableVMNetworkOptimization <Boolean>]
[-VMNetwork <VMNetwork>]
[-PortClassification <PortClassification>]
[-VMSubnet <VMSubnet>]
[-VLanEnabled <Boolean>]
[-VLanID <UInt16>]
[-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
[-AdapterFlags <VirtualNetworkAdapterFlags>]
-VMTemplate <Template>
[[-VirtualNetwork] <String>]
[-MACAddress <String>]
[-MACAddressType <String>]
[-NoConnection]
[-Synthetic]
[-LogicalNetwork <LogicalNetwork>]
[-VMNetworkServiceSetting <String>]
[-NoVMNetwork]
[-VMwarePortGroup <String>]
[-NetworkLocation <String>]
[-NetworkTag <String>]
[-DevicePropertiesAdapterName <String>]
[-PortACL <PortACL>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] New-SCVirtualNetworkAdapter
[-IPv4AddressType <EthernetAddressType>]
[-IPv6AddressType <EthernetAddressType>]
[-EnableMACAddressSpoofing <Boolean>]
[-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
[-EnableVMNetworkOptimization <Boolean>]
[-VMNetwork <VMNetwork>]
[-PortClassification <PortClassification>]
[-VMSubnet <VMSubnet>]
[-VLanEnabled <Boolean>]
[-VLanID <UInt16>]
[-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
[-AdapterFlags <VirtualNetworkAdapterFlags>]
-HardwareProfile <HardwareProfile>
[[-VirtualNetwork] <String>]
[-MACAddress <String>]
[-MACAddressType <String>]
[-NoConnection]
[-Synthetic]
[-LogicalNetwork <LogicalNetwork>]
[-VMNetworkServiceSetting <String>]
[-NoVMNetwork]
[-VMwarePortGroup <String>]
[-NetworkLocation <String>]
[-NetworkTag <String>]
[-DevicePropertiesAdapterName <String>]
[-PortACL <PortACL>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] New-SCVirtualNetworkAdapter
[-IPv4AddressType <EthernetAddressType>]
[-IPv6AddressType <EthernetAddressType>]
[-VMNetwork <VMNetwork>]
[-PortClassification <PortClassification>]
[-VMSubnet <VMSubnet>]
[-VLanEnabled <Boolean>]
[-VLanID <UInt16>]
[-IPv4AddressPool <StaticIPAddressPool>]
[-IPv6AddressPool <StaticIPAddressPool>]
[-InheritsAddressFromPhysicalNetworkAdapter <Boolean>]
-VMHost <Host>
-LogicalSwitch <LogicalSwitch>
[-JobGroup <Guid>]
[-Name <String>]
[-MACAddress <String>]
[-MACAddressType <String>]
[-IPv4Address <String>]
[-IPv6Address <String>]
[-PortACL <PortACL>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Description
O cmdlet new-SCVirtualNetworkAdapter cria um adaptador de rede virtual em uma máquina virtual, modelo de máquina virtual ou perfil de hardware usado para criar máquinas virtuais gerenciadas pelo VMM (Virtual Machine Manager).
Local da rede
Você pode usar o cmdlet New-SCVirtualNetworkAdapter para especificar um local de rede e conectar o adaptador de rede virtual a uma rede virtual configurada no host ao criar o adaptador ou definir essas e outras configurações posteriormente usando o cmdlet Set-SCVirtualNetworkAdapter.
Endereço MAC estático ou dinâmico
Você pode especificar se o adaptador de rede virtual usa um endereço MAC estático ou dinâmico e pode especificar um endereço MAC estático.
Adaptadores de rede virtual emulados ou sintéticos
Você pode usar o cmdlet New-SCVirtualNetworkAdapter para criar um adaptador cujo tipo é emulado (o padrão) ou sintético.
Para máquinas virtuais em qualquer tipo de host (Hyper-V, VMware ou XenServer), você pode configurar um adaptador de rede virtual na máquina virtual que emula um adaptador de rede físico específico.
Para máquinas virtuais em hosts Hyper-V, se o sistema operacional convidado instalado em uma máquina virtual for um sistema operacional com reconhecimento de virtualização (por exemplo, Windows Server 2008 ou Windows Server 2016 e algumas versões do Linux), o VMM permitirá que você configure um adaptador de rede virtual sintético de alto desempenho na máquina virtual para se comunicar com o hardware físico no host. Você deve especificar explicitamente que um adaptador de rede virtual é sintético usando o parâmetro Synthetic.
Rede de Área Local Virtual
O VMM inclui suporte para configurar uma ou mais VLANs (redes de área virtual) em um host para uso por máquinas virtuais implantadas nesse host.
Você pode usar o cmdlet
Para obter uma ilustração de como configurar VLANs, consulte os exemplos para este cmdlet e veja os exemplos para New-SCVMHostNetworkAdapterConfig e Set-SCVMHostNetworkAdapter.
Nota
- Um novo parâmetro [-PhysicalNetworkAdapterName] está incluído no VMM 2019 UR2 e posterior. Para obter mais informações, consulteparâmetros de
. - Novos parâmetros
[-AllowedVLanList] e[-NativeVLanId] estão incluídos no VMM 2019 UR3 e posterior. Para obter mais informações, consulteparâmetros de .
Exemplos
Exemplo 1: criar um adaptador de rede virtual em uma máquina virtual
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> New-SCVirtualNetworkAdapter -VM $VMO primeiro comando obtém o objeto de máquina virtual chamado VM01 e armazena o objeto na variável $VM.
O segundo comando cria um adaptador de rede virtual na VM01.
Exemplo 2: criar um adaptador de rede virtual em um modelo de máquina virtual
PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> New-SCVirtualNetworkAdapter -VMTemplate $VMTemplateO primeiro comando obtém o objeto de modelo de máquina virtual chamado VMTemplate01 e armazena o objeto na variável $VMTemplate.
O segundo comando cria um adaptador de rede virtual no VMTemplate01.
Exemplo 3: Criar um adaptador de rede virtual emulado e um adaptador de rede virtual sintética em um perfil de hardware
PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> New-SCVirtualNetworkAdapter -HardwareProfile $HWProfile
PS C:\> New-SCVirtualNetworkAdapter -HardwareProfile $HWProfile -SyntheticO primeiro comando obtém o objeto de perfil de hardware chamado NewHWProfile01 da biblioteca do VMM e armazena o objeto na variável $HWProfile.
O segundo comando cria um adaptador de rede virtual (um adaptador "nativo" ou emulado) em NewHWProfile01.
O último comando cria um adaptador de rede virtual sintético em NewHWProfile01.
Exemplo 4: criar um adaptador de rede virtual em uma máquina virtual e atribuí-lo a um endereço MAC exclusivo
PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> $VNIC = New-SCVirtualNetworkAdapter -VM $VM
PS C:\> $MACPool = Get-SCMACAddressPool -Name "MAC Address Pool 01"
PS C:\> Grant-SCMACAddress -MACAddressPool $MACPool -VirtualNetworkAdapter $VNICO primeiro comando obtém o objeto de máquina virtual chamado VM04 e armazena o objeto na variável $VM.
O segundo comando cria um adaptador de rede virtual na máquina virtual armazenada em $VM (VM04) e armazena o objeto na variável $VNIC.
O terceiro comando obtém o objeto de pool de endereços MAC chamado Mac Address Pool 01 e armazena o objeto na variável $MACPool.
O último comando obtém o próximo endereço MAC disponível do pool de endereços armazenado em $MACPool e o atribui ao adaptador de rede virtual armazenado em $VNIC.
Exemplo 5: criar um adaptador de rede virtual com um endereço MAC estático e uma ID de VLAN específica
PS C:\> $VM = Get-SCVirtualMachine -Name "VM05"
PS C:\> $LogicalNet = Get-SCLogicalNetwork -Name "LogicalNetwork01"
PS C:\> $VirtualNet = Get-SCVirtualNetwork -Name "ExternalVirtualNetwork01"
PS C:\> New-SCVirtualNetworkAdapter -VM $VM -LogicalNetwork $LogicalNet -VirtualNetwork $VirtualNet -MACAddress "00-16-D3-CC-00-1A" -MACAddressType "Static" -VLANEnabled $True -VLANId 3O primeiro comando obtém o objeto de máquina virtual chamado VM05 e armazena o objeto na variável $VM.
O segundo comando obtém o objeto de rede lógica chamado LogicalNetwork01 e armazena o objeto na variável $LogicalNet.
O terceiro comando obtém o objeto de rede virtual chamado ExternalVirtualNetwork01 e armazena o objeto na variável $VirtualNet.
O último comando cria um novo adaptador de rede virtual para VM05, conecta o adaptador à rede lógica armazenada em $LogicalNet e à rede virtual armazenada em $VirtualNet. O comando fornece um endereço MAC estático para o adaptador de rede virtual, habilita a VLAN e especifica uma ID de VLAN de 3.
Observação: este exemplo pressupõe que seu host já esteja conectado a uma VLAN ou, se não, que seu host tenha dois adaptadores de rede. Se o host tiver um único adaptador de rede, atribuir o adaptador a uma VLAN indisponível ao servidor VMM impedirá o VMM de gerenciar o host.
Parâmetros
-AdapterFlags
{{Fill AdapterFlags Description}}
| Tipo: | VirtualNetworkAdapterFlags |
| Valores aceitos: | None, ApplyInfrastructurePortProfileForNetworkController, ApplyNCPortProfileForNetworkController, ApplyInstaceIDPortProfileForNetworkController |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-AllowedVLanList
Especifica uma lista de LANs virtuais permitidas em um adaptador de rede de máquina virtual.
Nota
Esse parâmetro é aplicável ao VMM 2019 UR3 e posterior.
| Tipo: | UInt16 |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DevicePropertiesAdapterName
Especifica o nome de um adaptador de rede.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DevicePropertiesAdapterNameMode
Especifica o modo de nome do adaptador.
| Tipo: | DevicePropertiesAdapterNameMode |
| Valores aceitos: | Disabled, VMNetwork, Custom |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-EnableGuestIPNetworkVirtualizationUpdates
Indica se as atualizações de virtualização de rede IP por um convidado estão habilitadas.
| Tipo: | Boolean |
| Aliases: | GuestIPNetworkVirtualizationUpdatesEnabled |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-EnableMACAddressSpoofing
Habilita, quando definido como $True, falsificação de endereço MAC.
| Tipo: | Boolean |
| Aliases: | MACAddressesSpoofingEnabled |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-EnableVMNetworkOptimization
Habilita, quando definido como $True, otimização de rede de máquina virtual.
Esse recurso melhora o desempenho da rede para máquinas virtuais com adaptadores de rede que dão suporte a fila de máquinas virtuais (VMQ) ou descarregamento de chaminé TCP. O VMQ permite a criação de uma fila de rede exclusiva para cada adaptador de rede virtual. O descarregamento de chaminé TCP permite que o processamento de tráfego de rede seja descarregado da pilha de rede.
| Tipo: | Boolean |
| Aliases: | VMNetworkOptimizationEnabled |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-HardwareProfile
Especifica um objeto de perfil de hardware.
| Tipo: | HardwareProfile |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-InheritsAddressFromPhysicalNetworkAdapter
Indica se o adaptador de rede herda seu endereço de um adaptador de rede físico.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-IPv4Address
Especifica um endereço IPv4.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-IPv4AddressPool
Especifica um pool de endereços estático que contém endereços IPv4.
| Tipo: | StaticIPAddressPool |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-IPv4AddressType
Especifica um tipo de endereço IPv4. Os valores aceitáveis para este parâmetro são:
- Dinâmico
- Estático
| Tipo: | EthernetAddressType |
| Valores aceitos: | Dynamic, Static |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-IPv6Address
Especifica um endereço IPv6.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-IPv6AddressPool
Especifica um pool de endereços estático que contém endereços IPv6.
| Tipo: | StaticIPAddressPool |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-IPv6AddressType
Especifica um tipo de endereço IPv6. Os valores aceitáveis para este parâmetro são:
- Dinâmico
- Estático
| Tipo: | EthernetAddressType |
| Valores aceitos: | Dynamic, Static |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-JobGroup
Especifica um identificador para uma série de comandos que serão executados como um conjunto pouco antes do comando final que inclui o mesmo identificador de grupo de trabalho ser executado.
| Tipo: | Guid |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-JobVariable
Especifica que o progresso do trabalho é acompanhado e armazenado na variável nomeada por esse parâmetro.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-LogicalNetwork
Especifica uma rede lógica. Uma rede lógica é um agrupamento nomeado de sub-redes IP e VLANs que é usado para organizar e simplificar atribuições de rede.
| Tipo: | LogicalNetwork |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-LogicalSwitch
Especifica um objeto de comutador lógico.
| Tipo: | LogicalSwitch |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-MACAddress
Especifica o endereço MAC ou um conjunto de endereços MAC para um adaptador de rede física ou virtual em um computador.
- Formato de exemplo para um único endereço MAC:
-MACAddress "00-15-5D-B4-DC-00" - Formato de exemplo para um conjunto de endereços MAC:
-MACAddress "00-15-5D-B4-DC-00", "00-1A-A0-E3-75-29"
| Tipo: | String |
| Aliases: | EthernetAddress, PhysicalAddress |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-MACAddressType
Especifica o tipo de endereço MAC a ser usado para um adaptador de rede virtual. Os valores válidos são: Estático, Dinâmico.
| Tipo: | String |
| Aliases: | EthernetAddressType, PhysicalAddressType |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Name
Especifica o nome de um objeto de rede.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-NativeVLanId
Especifica o identificador de LAN virtual nativo para um adaptador de rede de máquina virtual.
Nota
Esse parâmetro é aplicável ao VMM 2019 UR3 e posterior.
| Tipo: | UInt16 |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-NetworkLocation
Especifica o local de rede para um adaptador de rede física ou para um adaptador de rede virtual ou altera o local de rede padrão do adaptador de rede física de um host.
Formatos de exemplo: -NetworkLocation $NetLoc ($NetLoc pode conter Corp.Contoso.com) -OverrideNetworkLocation $True -NetworkLocation "HostNICNewLocation.Contoso.com"
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-NetworkTag
Especifica uma palavra ou frase a ser associada a um adaptador de rede virtual configurado para se conectar a uma rede interna ou externa específica no host.
O parâmetro NetworkTag identifica todas as máquinas virtuais com o mesmo NetworkTag que os membros da mesma rede. O VMM usa um NeworkTag (se houver) quando avalia os hosts como possíveis candidatos para implantar uma máquina virtual. Se o host não incluir máquinas virtuais na rede com o mesmo NetworkTag que a máquina virtual a ser colocada, o host receberá zero estrelas no processo de posicionamento.
| Tipo: | String |
| Aliases: | Tag |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-NoConnection
Desconecta um adaptador de rede virtual de uma rede virtual.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-NoVMNetwork
Indica que uma rede de máquina virtual não está especificada.
| Tipo: | SwitchParameter |
| Aliases: | NoLogicalNetwork |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-OnBehalfOfUser
Especifica um nome de usuário. Esse cmdlet opera em nome do usuário especificado por esse parâmetro.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-OnBehalfOfUserRole
Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole. Esse cmdlet opera em nome da função de usuário especificada por esse parâmetro.
| Tipo: | UserRole |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-PhysicalNetworkAdapterName
Especifica o nome do adaptador de rede física.
Nota
Esse parâmetro é aplicável ao VMM 2019 UR2 e posterior.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-PortACL
Especifica um objeto ACL de porta.
| Tipo: | PortACL |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-PortClassification
Especifica a classificação de porta da opção à qual o adaptador de rede virtual se conecta.
| Tipo: | PortClassification |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-PROTipID
Especifica a ID da dica de Otimização de Recursos e Desempenho (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.
| Tipo: | Guid |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-RunAsynchronously
Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Synthetic
Especifica que um dispositivo, como um adaptador de rede virtual, em uma máquina virtual implantada em um host Hyper-V é um dispositivo sintético de alto desempenho. Requer um sistema operacional convidado com reconhecimento de virtualização na máquina virtual.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-VirtualNetwork
Especifica um objeto de rede virtual.
| Tipo: | String |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-VLanEnabled
Indica se uma LAN virtual (VLAN) deve ser habilitada para uso por máquinas virtuais em um host Hyper-V ou Citrix XenServer.
- Formato de exemplo para uma única VLAN:
-VLANEnabled -VLANMode "Access" -VLANID 35 - Formato de exemplo para vários VLANs:
-VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-VLanID
Atribui um identificador numérico no intervalo de 1 a 4094 a um adaptador de rede virtual em uma máquina virtual ou a um adaptador de rede física em um host de máquina virtual.
Configure uma VLanID em um host Hyper-V, VMware ESX ou Citrix XenServer em um adaptador de rede físico associado externamente quando o modo VLan for Access.
Configure uma VLanID em um adaptador de rede virtual de uma máquina virtual associada a um adaptador de rede física no host ou vinculada a uma rede virtual interna no host.
Formato de exemplo: -VLanEnabled -VLanMode "Access" -VLANID 35
| Tipo: | UInt16 |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-VM
Especifica um objeto de máquina virtual.
| Tipo: | VM |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-VMHost
Especifica um objeto de host de máquina virtual. O VMM dá suporte a hosts Hyper-V, hosts VMware ESX e hosts Citrix XenServer.
Para obter mais informações sobre cada tipo de host, consulte o cmdlet Add-SCVMHost.
| Tipo: | Host |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-VMMServer
Especifica um objeto de servidor do VMM.
| Tipo: | ServerConnection |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | 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 |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-VMNetworkServiceSetting
Especifica uma configuração de serviço de rede de máquina virtual.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-VMSubnet
Especifica um objeto de sub-rede de máquina virtual.
Para obter um objeto VMSubnet, use o cmdlet Get-SCVMSubnet.
| Tipo: | VMSubnet |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-VMTemplate
Especifica um objeto de modelo do VMM usado para criar máquinas virtuais.
| Tipo: | Template |
| Aliases: | Template |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-VMwarePortGroup
Especifica o grupo de portas do VMware.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
Saídas
VirtualNetworkAdapter
Esse cmdlet retorna um objeto VirtualNetworkAdapter.
Observações
- Requer um objeto de máquina virtual do VMM, um objeto de modelo de máquina virtual ou um objeto de perfil de hardware, que pode ser recuperado usando o Get-SCVirtualMachine, Get-SCVMTemplatee cmdlets Get-SCHardwareProfile, respectivamente.