Partilhar via

New-SCVirtualNetworkAdapter

Módulo:
VirtualMachineManager Module

Cria um adaptador de rede virtual em uma máquina virtual, modelo de máquina virtual ou perfil de hardware usado no VMM.

Sintaxe

VM (Predefinição) 

New-SCVirtualNetworkAdapter
    [[-VirtualNetwork] <String>]
    -VM <VM>
    [-IPv4AddressType <EthernetAddressType>]
    [-IPv6AddressType <EthernetAddressType>]
    [-EnableMACAddressSpoofing <Boolean>]
    [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
    [-EnableVMNetworkOptimization <Boolean>]
    [-VMNetwork <VMNetwork>]
    [-PortClassification <PortClassification>]
    [-VMSubnet <VMSubnet>]
    [-VLanEnabled <Boolean>]
    [-VLanID <UInt16>]
    [-AdapterFlags <VirtualNetworkAdapterFlags>]
    [-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>]

JobGroup 

New-SCVirtualNetworkAdapter
    [[-VirtualNetwork] <String>]
    -JobGroup <Guid>
    [-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>]
    [-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>]

Template 

New-SCVirtualNetworkAdapter
    [[-VirtualNetwork] <String>]
    -VMTemplate <Template>
    [-IPv4AddressType <EthernetAddressType>]
    [-IPv6AddressType <EthernetAddressType>]
    [-EnableMACAddressSpoofing <Boolean>]
    [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
    [-EnableVMNetworkOptimization <Boolean>]
    [-VMNetwork <VMNetwork>]
    [-PortClassification <PortClassification>]
    [-VMSubnet <VMSubnet>]
    [-VLanEnabled <Boolean>]
    [-VLanID <UInt16>]
    [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
    [-AdapterFlags <VirtualNetworkAdapterFlags>]
    [-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>]

HardwareProfile 

New-SCVirtualNetworkAdapter
    [[-VirtualNetwork] <String>]
    -HardwareProfile <HardwareProfile>
    [-IPv4AddressType <EthernetAddressType>]
    [-IPv6AddressType <EthernetAddressType>]
    [-EnableMACAddressSpoofing <Boolean>]
    [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
    [-EnableVMNetworkOptimization <Boolean>]
    [-VMNetwork <VMNetwork>]
    [-PortClassification <PortClassification>]
    [-VMSubnet <VMSubnet>]
    [-VLanEnabled <Boolean>]
    [-VLanID <UInt16>]
    [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
    [-AdapterFlags <VirtualNetworkAdapterFlags>]
    [-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>]

VMHost 

New-SCVirtualNetworkAdapter
    -VMHost <Host>
    -LogicalSwitch <LogicalSwitch>
    [-IPv4AddressType <EthernetAddressType>]
    [-IPv6AddressType <EthernetAddressType>]
    [-VMNetwork <VMNetwork>]
    [-PortClassification <PortClassification>]
    [-VMSubnet <VMSubnet>]
    [-VLanEnabled <Boolean>]
    [-VLanID <UInt16>]
    [-IPv4AddressPool <StaticIPAddressPool>]
    [-IPv6AddressPool <StaticIPAddressPool>]
    [-InheritsAddressFromPhysicalNetworkAdapter <Boolean>]
    [-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 Virtual Machine Manager (VMM).

Localização 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 pode 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ísica 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á configurar 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 New-SCVirtualNetworkAdapter (ou o cmdlet Set-SCVirtualNetworkAdapter ) com os parâmetros VLAN para anexar o adaptador de rede virtual em uma máquina virtual a uma VLAN. Para definir as configurações de VLAN correspondentes no adaptador de rede do host, use o cmdlet Add-SCVMHostNetworkAdapter ou o cmdlet Set-SCVMHostNetworkAdapter .

Para obter uma ilustração de como configurar VLANs, consulte os exemplos deste cmdlet e os exemplos de New-SCVMHostNetworkAdapterConfig e Set-SCVMHostNetworkAdapter.

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 $VM

O 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 no 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 $VMTemplate

O 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ético 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 -Synthetic

O 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 atribuir-lhe 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 $VNIC

O 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 no $VM (VM04) e armazena o objeto na variável $VNIC.

O terceiro comando obtém o objeto do 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 no $MACPool e o atribui ao adaptador de rede virtual armazenado no $VNIC.

Exemplo 5: Criar um adaptador de rede virtual com um endereço MAC estático e um ID de VLAN específico

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 3

O 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 no $LogicalNet e à rede virtual armazenada no $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.

Nota: Este exemplo pressupõe que o host já esteja conectado a uma VLAN ou, se não, que o host tenha dois adaptadores de rede. Se o host tiver um único adaptador de rede, atribuir o adaptador a uma VLAN que não está disponível para o servidor VMM impedirá que o VMM gerencie o host.

Parâmetros

-AdapterFlags

{{Descrição do Fill AdapterFlags}}

Propriedades dos parâmetros

Tipo:VirtualNetworkAdapterFlags
Default value:None
Valores aceites:None, ApplyInfrastructurePortProfileForNetworkController, ApplyNCPortProfileForNetworkController, ApplyInstaceIDPortProfileForNetworkController
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

VM
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
JobGroup
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
Template
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
HardwareProfile
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-AllowedVLanList

Especifica uma lista de LANs virtuais permitidas em um adaptador de rede de máquina virtual.

Propriedades dos parâmetros

Tipo:UInt16
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DevicePropertiesAdapterName

Especifica o nome de um adaptador de rede.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

JobGroup
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
Template
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
HardwareProfile
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DevicePropertiesAdapterNameMode

Especifica o modo de nome do adaptador.

Propriedades dos parâmetros

Tipo:DevicePropertiesAdapterNameMode
Default value:None
Valores aceites:Disabled, VMNetwork, Custom
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

JobGroup
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
Template
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
HardwareProfile
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-EnableGuestIPNetworkVirtualizationUpdates

Indica se as atualizações de virtualização de rede IP feitas por um convidado estão habilitadas.

Propriedades dos parâmetros

Tipo:Boolean
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:GuestIPNetworkVirtualizationUpdatesEnabled

Conjuntos de parâmetros

VM
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
JobGroup
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
Template
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
HardwareProfile
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-EnableMACAddressSpoofing

Habilita, quando definido como $True, falsificação de endereço MAC.

Propriedades dos parâmetros

Tipo:Boolean
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:MACAddressesSpoofingEnabled

Conjuntos de parâmetros

VM
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
JobGroup
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
Template
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
HardwareProfile
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-EnableVMNetworkOptimization

Permite, quando definido como $True, a otimização da rede da máquina virtual.

Esse recurso melhora o desempenho da rede para máquinas virtuais com adaptadores de rede que suportam fila de máquina virtual (VMQ) ou descarregamento de chaminé TCP. O VMQ permite criar uma fila de rede exclusiva para cada adaptador de rede virtual. O TCP Chimney Offload permite que o processamento do tráfego de rede seja descarregado da pilha de rede.

Propriedades dos parâmetros

Tipo:Boolean
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:VMNetworkOptimizationEnabled

Conjuntos de parâmetros

VM
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
JobGroup
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
Template
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
HardwareProfile
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-HardwareProfile

Especifica um objeto de perfil de hardware.

Propriedades dos parâmetros

Tipo:HardwareProfile
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

HardwareProfile
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-InheritsAddressFromPhysicalNetworkAdapter

Indica se o adaptador de rede herda seu endereço de um adaptador de rede físico.

Propriedades dos parâmetros

Tipo:Boolean
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

VMHost
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-IPv4Address

Especifica um endereço IPv4.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

VMHost
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-IPv4AddressPool

Especifica um pool de endereços estáticos que contém endereços IPv4.

Propriedades dos parâmetros

Tipo:StaticIPAddressPool
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

VMHost
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-IPv4AddressType

Especifica um tipo de endereço IPv4. Os valores aceitáveis para este parâmetro são:

  • Dinâmica
  • Estático

Propriedades dos parâmetros

Tipo:EthernetAddressType
Default value:None
Valores aceites:Dynamic, Static
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-IPv6Address

Especifica um endereço IPv6.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

VMHost
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-IPv6AddressPool

Especifica um pool de endereços estáticos que contém endereços IPv6.

Propriedades dos parâmetros

Tipo:StaticIPAddressPool
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

VMHost
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-IPv6AddressType

Especifica um tipo de endereço IPv6. Os valores aceitáveis para este parâmetro são:

  • Dinâmica
  • Estático

Propriedades dos parâmetros

Tipo:EthernetAddressType
Default value:None
Valores aceites:Dynamic, Static
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-JobGroup

Especifica um identificador para uma série de comandos que serão executados como um conjunto imediatamente antes da execução do comando final que inclui o mesmo identificador de grupo de trabalhos.

Propriedades dos parâmetros

Tipo:Guid
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

JobGroup
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-JobVariable

Especifica que o progresso do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:LogicalNetwork
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

VM
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
JobGroup
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
Template
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
HardwareProfile
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-LogicalSwitch

Especifica um objeto de comutador lógico.

Propriedades dos parâmetros

Tipo:LogicalSwitch
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

JobGroup
Position:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-MACAddress

Especifica o endereço MAC, ou um conjunto de endereços MAC, para um adaptador de rede físico ou virtual em um computador.

  • Exemplo de formato para um único endereço MAC: -MACAddress "00-15-5D-B4-DC-00"
  • Exemplo de formato para um conjunto de endereços MAC: -MACAddress "00-15-5D-B4-DC-00", "00-1A-A0-E3-75-29"

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:EthernetAddress, Endereço Físico

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:EthernetAddressType, PhysicalAddressType

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

Especifica o nome de um objeto de rede.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

VMHost
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-NativeVLanId

Especifica o identificador de LAN virtual nativo para um adaptador de rede de máquina virtual.

Propriedades dos parâmetros

Tipo:UInt16
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-NetworkLocation

Especifica o local de rede para um adaptador de rede físico 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 podem conter Corp.Contoso.com) -OverrideNetworkLocation $True -NetworkLocation "HostNICNewLocation.Contoso.com"

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

VM
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
JobGroup
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
Template
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
HardwareProfile
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 como membros da mesma rede. O VMM usa uma NeworkTag (se existir) quando avalia hosts como possíveis candidatos para implantar uma máquina virtual. Se o host não incluir máquinas virtuais na rede com a mesma NetworkTag que a máquina virtual a ser colocada, o host receberá zero estrelas no processo de posicionamento.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Etiqueta

Conjuntos de parâmetros

VM
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
JobGroup
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
Template
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
HardwareProfile
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-NoConnection

Desconecta um adaptador de rede virtual de uma rede virtual.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

VM
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
JobGroup
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
Template
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
HardwareProfile
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-NoVMNetwork

Indica que uma rede de máquina virtual não é especificada.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:NoLogicalNetwork

Conjuntos de parâmetros

VM
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
JobGroup
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
Template
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
HardwareProfile
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-OnBehalfOfUser

Especifica um nome de usuário. Este cmdlet opera em nome do usuário especificado por esse parâmetro.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:UserRole
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PhysicalNetworkAdapterName

Especifica o nome do adaptador de rede física.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PortACL

Especifica um objeto ACL de porta.

Propriedades dos parâmetros

Tipo:PortACL
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PortClassification

Especifica a classificação de porta do switch ao qual o adaptador de rede virtual se conecta.

Propriedades dos parâmetros

Tipo:PortClassification
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:Guid
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

VM
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
JobGroup
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
Template
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
HardwareProfile
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-VirtualNetwork

Especifica um objeto de rede virtual.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

VM
Position:0
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
JobGroup
Position:0
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
Template
Position:0
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
HardwareProfile
Position:0
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

  • Exemplo de formato para uma única VLAN: -VLANEnabled -VLANMode "Access" -VLANID 35
  • Exemplo de formato para várias VLANs: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124

Propriedades dos parâmetros

Tipo:Boolean
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-VLanID

Atribui um identificador numérico no intervalo 1-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 um VLanID em um host Hyper-V, VMware ESX ou Citrix XenServer em um adaptador de rede física vinculado externamente quando o modo VLan for Access.

Configure um VLanID em um adaptador de rede virtual de uma máquina virtual vinculada a um adaptador de rede física no host ou vinculada a uma rede virtual interna no host.

Exemplo de formato: -VLanEnabled -VLanMode "Access" -VLANID 35

Propriedades dos parâmetros

Tipo:UInt16
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-VM

Especifica um objeto de máquina virtual.

Propriedades dos parâmetros

Tipo:VM
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

VM
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-VMHost

Especifica um objeto de host de máquina virtual. O VMM suporta hosts Hyper-V, VMware ESX e Citrix XenServer.

Para obter mais informações sobre cada tipo de host, consulte o cmdlet Add-SCVMHost .

Propriedades dos parâmetros

Tipo:Host
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

JobGroup
Position:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-VMMServer

Especifica um objeto de servidor VMM.

Propriedades dos parâmetros

Tipo:ServerConnection
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

JobGroup
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 .

Propriedades dos parâmetros

Tipo:VMNetwork
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-VMNetworkServiceSetting

Especifica uma configuração de serviço de rede de máquina virtual.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

JobGroup
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-VMSubnet

Especifica um objeto de sub-rede de máquina virtual.

Para obter um objeto VMSubnet , use o cmdlet Get-SCVMSubnet .

Propriedades dos parâmetros

Tipo:VMSubnet
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-VMTemplate

Especifica um objeto de modelo do VMM usado para criar máquinas virtuais.

Propriedades dos parâmetros

Tipo:Template
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Modelo

Conjuntos de parâmetros

Template
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-VMwarePortGroup

Especifica o grupo de portas VMware.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

VM
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
JobGroup
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
Template
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
HardwareProfile
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Saídas

VirtualNetworkAdapter

Este cmdlet retorna um objeto VirtualNetworkAdapter .

Notas

  • 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 os cmdlets Get-SCVirtualMachine, Get-SCVMTemplate e Get-SCHardwareProfile , respectivamente.