Partilhar via

New-SCLogicalSwitchVirtualNetworkAdapter

Módulo:
VirtualMachineManager Module

Adiciona um adaptador de rede virtual (VNIC) a um comutador lógico.

Sintaxe

Default (Predefinição) 

New-SCLogicalSwitchVirtualNetworkAdapter
    -UplinkPortProfileSet <UplinkPortProfileSet>
    [-EthernetAddressType <EthernetAddressType>]
    [-IPv4AddressType <EthernetAddressType>]
    [-IPv6AddressType <EthernetAddressType>]
    [-VMNetwork <VMNetwork>]
    [-VMSubnet <VMSubnet>]
    [-PortClassification <PortClassification>]
    [-VLanEnabled <Boolean>]
    [-VLanID <UInt16>]
    [-IPv4AddressPool <StaticIPAddressPool>]
    [-IPv6AddressPool <StaticIPAddressPool>]
    [-InheritsAddressFromPhysicalNetworkAdapter <Boolean>]
    [-IsUsedForHostManagement <Boolean>]
    [-VMMServer <ServerConnection>]
    [-Name] <String>
    [[-Description] <String>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Description

O cmdlet New-SCLogicalSwitchVirtualNetworkAdapter adiciona um adaptador de rede virtual (VNIC) para o host ao Perfil da Porta de Uplink como parte da definição do comutador lógico.

Exemplos

Exemplo 1: Cria um novo adaptador de rede virtual de comutador lógico

PS C:\> $UPPSet = Get-SCUplinkPortProfileSet -Name "R1Uplink"
PS C:\> $VmNetwork = Get-SCVMNetwork -Name "MgmtNet"
PS C:\> New-SCLogicalSwitchVirtualNetworkAdapter -Name "LogSw01_Storage" -UplinkPortProfileSet $uppSetVar -RunAsynchronously -VMNetwork $vmNetwork -VLanEnabled $true -VLanID 2162 -IsUsedForHostManagement $false -IPv4AddressType "Dynamic" -IPv6AddressType "Dynamic"

O primeiro comando obtém um perfil de porta de uplink definido usando o cmdlet Get-SCUplinkPortProfileSet e o armazena na variável $UPPSet.

O segundo comando obtém a rede de máquina virtual chamada MgmtNet usando o cmdlet Get-SCVMNetwork e a armazena na variável $VmNetwork.

O comando final cria um adaptador de rede virtual de comutador lógico que é implantado no host junto com o comutador lógico.

Parâmetros

-Description

Especifica uma descrição para o adaptador de rede virtual.

Propriedades dos parâmetros

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

Conjuntos de parâmetros

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

-EthernetAddressType

Especifica um tipo de endereço Ethernet. 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

-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

(All)
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

(All)
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

-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

(All)
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

-IsUsedForHostManagement

Indica se o adaptador de rede virtual é usado para gerenciamento de host.

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

-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

-Name

Especifica o nome do adaptador de rede.

Propriedades dos parâmetros

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

Conjuntos de parâmetros

(All)
Position:0
Obrigatório:True
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

-UplinkPortProfileSet

Especifica um objeto de conjunto de perfil de porta de uplink.

Para obter um objeto de conjunto de perfil de porta de uplink, use o cmdlet Get-SCUplinkPortProfileSet .

Propriedades dos parâmetros

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

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:True
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

-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

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

-VMNetwork

Especifica um objeto de rede VM.

Para obter um objeto de rede VM, 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

-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:True
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.