Partilhar via

New-SCVMHostNetworkAdapterConfig

  • Referência
Módulo:
VirtualMachineManager

Cria uma configuração de adaptador de rede do host.

Sintaxe

New-SCVMHostNetworkAdapterConfig
   [-VMMServer <ServerConnection>]
   [-SetAsPhysicalNetworkAdapter]
   -LogicalSwitch <LogicalSwitch>
   -UplinkPortProfileSet <UplinkPortProfileSet>
   [-MACAddress <String>]
   [-ConsistentDeviceName <String>]
   [-DisableAdapterDNSRegistration <Boolean>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterConfig
   [-VMMServer <ServerConnection>]
   [-SetAsPhysicalNetworkAdapter]
   [-SetAsGenericNIC]
   [-UseStaticIPForIPConfiguration]
   -LogicalNetwork <LogicalNetwork>
   [-MACAddress <String>]
   [-ConsistentDeviceName <String>]
   [-IPv4Subnet <String>]
   [-IPv6Subnet <String>]
   [-IPv4Address <String>]
   [-IPv6Address <String>]
   [-DisableAdapterDNSRegistration <Boolean>]
   [-AdapterName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterConfig
   [-VMMServer <ServerConnection>]
   [-SetAsPhysicalNetworkAdapter]
   [-SetAsManagementNIC]
   [-UseDhcpForIPConfiguration]
   [-MACAddress <String>]
   [-ConsistentDeviceName <String>]
   [-AdapterName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterConfig
   [-VMMServer <ServerConnection>]
   [-SetAsPhysicalNetworkAdapter]
   [-SetAsGenericNIC]
   [-UseDhcpForIPConfiguration]
   [-MACAddress <String>]
   [-ConsistentDeviceName <String>]
   [-DisableAdapterDNSRegistration <Boolean>]
   [-AdapterName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterConfig
   [-VMMServer <ServerConnection>]
   [-SetAsPhysicalNetworkAdapter]
   [-SetAsManagementNIC]
   [-UseStaticIPForIPConfiguration]
   -LogicalNetwork <LogicalNetwork>
   [-MACAddress <String>]
   [-ConsistentDeviceName <String>]
   [-IPv4Subnet <String>]
   [-IPv6Subnet <String>]
   [-IPv4Address <String>]
   [-IPv6Address <String>]
   [-AdapterName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterConfig
   [-VMMServer <ServerConnection>]
   [-SetAsVirtualNetworkAdapter]
   [-SetAsGenericNIC]
   [-UseDhcpForIPConfiguration]
   -LogicalSwitch <LogicalSwitch>
   [-PortClassification <PortClassification>]
   -VMNetwork <VMNetwork>
   [-MACAddress <String>]
   [-AdapterName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterConfig
   [-VMMServer <ServerConnection>]
   [-SetAsVirtualNetworkAdapter]
   [-SetAsGenericNIC]
   [-UseStaticIPForIPConfiguration]
   -LogicalSwitch <LogicalSwitch>
   [-PortClassification <PortClassification>]
   -VMNetwork <VMNetwork>
   [-MACAddress <String>]
   [-IPv4Subnet <String>]
   [-IPv6Subnet <String>]
   [-IPv4Address <String>]
   [-IPv6Address <String>]
   [-AdapterName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterConfig
   [-VMMServer <ServerConnection>]
   [-SetAsVirtualNetworkAdapter]
   [-SetAsManagementNIC]
   -TransientManagementNetworkAdapter <PhysicalComputerNetworkAdapterConfig>
   [-UseDhcpForIPConfiguration]
   -LogicalSwitch <LogicalSwitch>
   [-PortClassification <PortClassification>]
   -VMNetwork <VMNetwork>
   [-MACAddress <String>]
   [-AdapterName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterConfig
   [-VMMServer <ServerConnection>]
   [-SetAsVirtualNetworkAdapter]
   [-SetAsManagementNIC]
   -TransientManagementNetworkAdapter <PhysicalComputerNetworkAdapterConfig>
   [-UseStaticIPForIPConfiguration]
   -LogicalSwitch <LogicalSwitch>
   [-PortClassification <PortClassification>]
   -VMNetwork <VMNetwork>
   [-MACAddress <String>]
   [-IPv4Subnet <String>]
   [-IPv6Subnet <String>]
   [-IPv4Address <String>]
   [-IPv6Address <String>]
   [-AdapterName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

O cmdlet New-SCVMHostNetworkAdapterConfig cria uma configuração do adaptador de rede do host que é usada durante o processo de implantação do sistema operacional do host.

Exemplos

Exemplo 1: Criar uma configuração de adaptador de rede de host físico de gerenciamento usando um endereço IP estático

PS C:\> $LogicalNetwork = Get-SCLogicalNetwork -Name "LogicalNetwork01"
PS C:\> New-SCVMHostNetworkAdapterConfig -SetAsPhysicalNetworkAdapter -SetAsManagementNIC -UseStaticIPForIPConfiguration -LogicalNetwork $LogicalNetwork -MacAddress "00-1D-D8-B7-1C-00" -IPv4Subnet "10.0.0.1/24"

O primeiro comando obtém o objeto de rede lógica chamado LogicalNetwork01 e armazena o objeto na variável $LogicalNetwork.

O segundo comando cria uma configuração de adaptador de rede de host físico, definindo-o como o adaptador de rede de gerenciamento e usa um endereço IP estático durante a configuração de IP. A configuração inclui LogicalNetwork01, o endereço MAC fornecido e a sub-rede especificada.

Exemplo 2: Criar uma configuração de adaptador de rede de host físico que usa um comutador lógico

PS C:\> $LogicalSwitch = Get-SCLogicalSwitch -Name "LogicalSwitch01"
PS C:\> $UplinkPortProfSet = Get-SCUplinkPortProfileSet -Name "UplinkPortProfileSet01"
PS C:\> New-SCVMHostNetworkAdapterConfig -SetAsPhysicalNetworkAdapter -LogicalSwitch $LogicalSwitch -UplinkPortProfileSet $UplinkPortProfSet

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

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 uma configuração de adaptador de rede host físico com LogicalSwitch01 e UplinkPortProfileSet01.

Exemplo 3: Criar uma configuração genérica do adaptador de rede do host virtual usando DHCP

PS C:\> $LogicalSwitch = Get-SCLogicalSwitch -Name "LogicalSwitch01"
PS C:\> $VMNetwork = Get-SCVMNetwork -Name "VMNetwork01"
PS C:\> New-SCVMHostNetworkAdapterConfig -SetAsVirtualNetworkAdapter -SetAsGenericNIC -UseDhcpForIPConfiguration -LogicalSwitch $LogicalSwitch -VMNetwork $VMNetwork

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

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

O último comando cria uma configuração de rede de host virtual genérica com LogicalSwtich01 e VMNetwork01 que usa DHCP para obter um endereço IP.

Parâmetros

-AdapterName

Especifica o nome do adaptador de rede.

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

-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

-DisableAdapterDNSRegistration

Indica se o registro DNS para o adaptador de rede deve ser desabilitado.

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

-IPv4Address

Especifica um endereço IPv4.

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

-IPv4Subnet

Especifica uma sub-rede IPv4.

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

-IPv6Address

Especifica um endereço IPv6.

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

-IPv6Subnet

Especifica uma sub-rede IPv6.

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

-MACAddress

Especifica o endereço MAC (Media Access Control) ou um conjunto de endereços MAC para um adaptador de rede físico ou virtual em um computador. Os valores válidos são: um ou mais endereços MAC.

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"

Exemplo de formato para um conjunto de endereços MAC:

$Macs = "00-15-5D-B4-DC-00", "00-1A-A0-E3-75-29"

Set-SCPXEServer -MACAddress $Macs

Tipo:String
Position:Named
Default value:None
Necessário:False
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:PhysicalComputerNetworkAdapterConfig
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

HostNetworkAdapterConfig

Este cmdlet retorna um objeto HostNetworkAdapterConfig.