Partilhar via

New-SCVMHostNetworkAdapterProfile

  • Referência
Módulo:
VirtualMachineManager

Cria um perfil de adaptador de rede de host.

Sintaxe

New-SCVMHostNetworkAdapterProfile
   [-VMMServer <ServerConnection>]
   [-SetAsPhysicalNetworkAdapter]
   [-SetAsGenericNIC]
   [-ConsistentDeviceName <String>]
   [-UseDhcpForIPConfiguration]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterProfile
   [-VMMServer <ServerConnection>]
   [-SetAsPhysicalNetworkAdapter]
   [-SetAsManagementNIC]
   [-ConsistentDeviceName <String>]
   [-UseDhcpForIPConfiguration]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterProfile
   [-VMMServer <ServerConnection>]
   [-SetAsPhysicalNetworkAdapter]
   [-SetAsGenericNIC]
   [-ConsistentDeviceName <String>]
   [-UseStaticIPForIPConfiguration]
   -LogicalNetwork <LogicalNetwork>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterProfile
   [-VMMServer <ServerConnection>]
   [-SetAsPhysicalNetworkAdapter]
   [-ConsistentDeviceName <String>]
   -LogicalSwitch <LogicalSwitch>
   -UplinkPortProfileSet <UplinkPortProfileSet>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterProfile
   [-VMMServer <ServerConnection>]
   [-SetAsPhysicalNetworkAdapter]
   [-SetAsManagementNIC]
   [-ConsistentDeviceName <String>]
   [-UseStaticIPForIPConfiguration]
   -LogicalNetwork <LogicalNetwork>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterProfile
   [-VMMServer <ServerConnection>]
   [-SetAsVirtualNetworkAdapter]
   [-SetAsManagementNIC]
   -TransientManagementNetworkAdapter <PhysicalComputerNetworkAdapterProfile>
   [-UseStaticIPForIPConfiguration]
   -LogicalSwitch <LogicalSwitch>
   [-PortClassification <PortClassification>]
   -VMNetwork <VMNetwork>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterProfile
   [-VMMServer <ServerConnection>]
   [-SetAsVirtualNetworkAdapter]
   [-SetAsGenericNIC]
   [-UseDhcpForIPConfiguration]
   -LogicalSwitch <LogicalSwitch>
   [-PortClassification <PortClassification>]
   -VMNetwork <VMNetwork>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterProfile
   [-VMMServer <ServerConnection>]
   [-SetAsVirtualNetworkAdapter]
   [-SetAsGenericNIC]
   [-UseStaticIPForIPConfiguration]
   -LogicalSwitch <LogicalSwitch>
   [-PortClassification <PortClassification>]
   -VMNetwork <VMNetwork>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterProfile
   [-VMMServer <ServerConnection>]
   [-SetAsVirtualNetworkAdapter]
   [-SetAsManagementNIC]
   -TransientManagementNetworkAdapter <PhysicalComputerNetworkAdapterProfile>
   [-UseDhcpForIPConfiguration]
   -LogicalSwitch <LogicalSwitch>
   [-PortClassification <PortClassification>]
   -VMNetwork <VMNetwork>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

O cmdlet New-SCVMHostNetworkAdapterProfile cria um perfil de adaptador de rede.

Observe que depois de criar um perfil de adaptador de rede, ele não pode ser atualizado. Para alterar um perfil de adaptador de rede, você deve remover o perfil do adaptador de rede e, em seguida, recriá-lo.

Exemplos

Exemplo 1: Criar um perfil genérico de adaptador de rede de host físico usando DHCP

PS C:\> New-SCVMHostNetworkAdapterProfile -SetAsPhysicalNetworkAdapter -SetAsGenericNIC -UseDhcpForIPConfiguration -ConsistentDeviceName "Physical host network adapter profile 01"

Este comando cria um perfil de adaptador de rede de host físico.

As opções usadas neste comando indicam que este é um adaptador de rede físico e que o adaptador de rede não é o adaptador de rede de gerenciamento para o host. Além disso, DHCP é usado para obter um endereço IP para o adaptador de rede.

Exemplo 2: Criar um perfil de adaptador de rede físico com um comutador lógico

PS C:\> $LogSwitch = Get-SCLogicalSwitch -Name "LogicalSwitch01"
PS C:\> $UplinkPortProfSet = Get-SCUplinkPortProfileSet -Name "UplinkPortProfileSet01"
PS C:\> New-SCVMHostNetworkAdapterProfile -SetAsPhysicalNetworkAdapter -LogicalSwitch $LogSwitch -UplinkPortProfileSet $UplinkPortProfSet -ConsistentDeviceName "Physical host network adapter profile 02"

O primeiro comando obtém o objeto de comutador lógico chamado LogicalSwitch01 e armazena o objeto na variável $LogSwitch.

O segundo comando obtém o objeto do conjunto de perfis de porta de uplink chamado UplinkPortProfileSet01 e armazena o objeto na variável $UplinkPortProfSet.

O último comando cria um perfil de adaptador de rede de host físico usando LogicalSwitch01 e UplinkPortProfileSet01.

Exemplo 3: Criar um perfil de adaptador de rede de host virtual de gerenciamento usando um endereço IP estático

PS C:\> $TransMgmtNIC = Get-SCVMHostNetworkAdapterProfile -ID "259f47c7-c5a9-429d-a421-d232f9b34991"
PS C:\> $LogSwitch = Get-SCLogicalSwitch -Name "LogicalSwitch01"
PS C:\> $VMNetwork = Get-SCVMNetwork -Name "VMNetwork01"
PS C:\> New-SCVMHostNetworkAdapterProfile -SetAsVirtualNetworkAdapter -SetAsManagementNIC -TransientManagementNetworkAdapter $TransMgmtNIC -UseStaticIPForIPConfiguration -LogicalSwitch $LogSwitch -VMNetwork $VMNetwork

O primeiro comando obtém o objeto de perfil do adaptador de rede host com a ID de 259f47c7-c5a9-429d-a421-d232f9b34991 e armazena o objeto na variável $TransMgmtNIC.

O segundo comando obtém o objeto de comutador lógico chamado LogicalSwitch01 e armazena o objeto na variável $LogSwitch.

O terceiro comando obtém o objeto de rede VM chamado VMNetwork01 e armazena o objeto na variável $VMNetwork.

O último comando cria um adaptador de rede de host virtual prfile como um adaptador de rede de gerenciamento usando LogicalSwitch01 e VMNetwork01.

Parâmetros

-ConsistentDeviceName

Especifica um nome de dispositivo consistente para um adaptador de rede.

Tipo:String
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

-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
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-LogicalSwitch

Especifica um objeto de comutador lógico.

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

-PortClassification

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

Tipo:PortClassification
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

-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

-SetAsGenericNIC

Indica que o adaptador de rede não é o adaptador de rede de gerenciamento para o host.

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

-SetAsManagementNIC

Indica que o adaptador de rede é o adaptador de rede de gerenciamento para o host.

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

-SetAsPhysicalNetworkAdapter

Indica que o adaptador de rede é um adaptador de rede físico.

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

-SetAsVirtualNetworkAdapter

Indica que o adaptador de rede é um adaptador de rede virtual.

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

-TransientManagementNetworkAdapter

Especifica o adaptador de rede física ao qual o adaptador de rede virtual de gerenciamento se liga durante a fase inicial de implantação do sistema operacional. Essa propriedade é usada temporariamente antes que o host seja implantado.

Tipo:PhysicalComputerNetworkAdapterProfile
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais: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.

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

-UseDhcpForIPConfiguration

Indica que o endereço IP do adaptador de rede é obtido usando DHCP.

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

-UseStaticIPForIPConfiguration

Indica que o adaptador de rede está configurado com um endereço IP estático.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
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 VM.

Para obter um objeto de rede VM, use o cmdlet Get-SCVMNetwork.

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

Saídas

HostNetworkAdapterProfile

Este cmdlet retorna um objeto HostNetworkAdapterProfile.