New-SCVMHost

Cria um hospedeiro VMM a partir de um computador físico utilizando as propriedades definidas num perfil de anfitrião.

Syntax

New-SCVMHost
   [-VMMServer <ServerConnection>]
   [-Description <String>]
   -ComputerName <String>
   -VMHostProfile <PhysicalComputerProfile>
   -SMBiosGuid <Guid>
   [-VMHostGroup <HostGroup>]
   [-IPAddress <String>]
   [-LogicalNetwork <LogicalNetwork>]
   [-Subnet <String>]
   [-BypassADMachineAccountCheck]
   [-ManagementAdapterMACAddress <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHost
   [-VMMServer <ServerConnection>]
   -VMHostConfig <PhysicalComputerConfig>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHost
   [-VMMServer <ServerConnection>]
   [-Description <String>]
   -ComputerName <String>
   -VMHostProfile <PhysicalComputerProfile>
   -SMBiosGuid <Guid>
   [-VMHostGroup <HostGroup>]
   [-IPAddress <String>]
   [-LogicalNetwork <LogicalNetwork>]
   [-Subnet <String>]
   [-BypassADMachineAccountCheck]
   [-ManagementAdapterMACAddress <String>]
   -BMCAddress <String>
   -BMCRunAsAccount <RunAsAccount>
   [-BMCPort <UInt32>]
   -BMCProtocol <OutOfBandManagementType>
   [-BMCCustomConfigurationProvider <ConfigurationProvider>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

O cmdlet New-SCVMHost cria um anfitrião Virtual Machine Manager (VMM) a partir de um computador físico utilizando as propriedades definidas num perfil de anfitrião. O computador físico deve ter um controlador fora de banda.

Antes de criar um anfitrião, certifique-se de que um servidor PXE foi adicionado ao VMM, foi criado um perfil de anfitrião e quaisquer ficheiros de controlador necessários foram adicionados à biblioteca. Nota: O servidor PXE que adiciona ao VMM deve estar na mesma sub-rede que os computadores físicos que pretende converter para anfitriões Hiper-V geridos.

Para mais informações sobre os tipos de anfitriões suportados por VMM, escreva Get-Help Add-SCVMHost -Detailed.

Exemplos

Exemplo 1: Criar um anfitrião a partir de um computador físico utilizando um perfil de anfitrião baseado em DHCP

PS C:\> $BMCRAA = Get-SCRunAsAccount -Name "BMCRunAsAcct"
PS C:\> $NewPhysicalComputer = Find-SCComputer -BMCAddress "10.10.0.1" -BMCRunAsAccount $BMCRAA -BMCProtocol "IPMI"
PS C:\> $HostGroup = Get-SCVMHostGroup -Name "HostGroup01"
PS C:\> $HostProfile = Get-SCVMHostProfile -Name "HostProfile01"
PS C:\> New-SCVMHost -VMHostGroup $HostGroup -VMHostProfile $HostProfile -ComputerName "NewHost01" -BMCAddress $NewPhysicalComputer.BMCAddress -BMCRunAsAccount $BMCRAA -BMCProtocol "IPMI" -SMBIOSGUID $NewPhysicalComputer.SMBIOSGUID -ManagementAdapterMACAddress "00-1D-D8-B7-1C-00" -LogicalNetwork "LogicalNetwork01" -Subnet "192.168.0.1/24" -IPAddress "192.168.0.91"

O primeiro comando obtém o objeto de conta Run As chamado BMCRunAsAcct e armazena o objeto na variável $BMCRAA.

O segundo comando descobre o computador físico com o endereço IP de 10.10.0.1 utilizando a conta Run As fornecida em $BMCRAA. Em seguida, armazena o computador físico na variável $NewPhysicalComputer.

O terceiro comando obtém o objeto do grupo anfitrião chamado HostGroup01 e armazena o objeto na variável $HostGroup.

O quarto comando obtém o objeto de perfil do anfitrião chamado HostProfile01 e armazena o objeto na variável $HostProfile. HostProfile01 está configurado para obter um endereço IP através do serviço DHCP.

O último comando cria um hospedeiro a partir do computador físico armazenado em $NewPhysicalComputer usando o perfil de anfitrião armazenado em $HostProfile, e dá-lhe o nome de NewHost01.

Exemplo 2: Criar um hospedeiro a partir de um computador físico utilizando um perfil de anfitrião estático baseado em IP

PS C:\> $BMCRAA = Get-SCRunAsAccount -Name "BMCRunAsAcct"
PS C:\> $NewPhysicalComputer = Find-SCComputer -BMCAddress "10.10.0.1" -BMCRunAsAccount $BMCRAA -BMCProtocol "IPMI"
PS C:\> $HostGroup = Get-SCVMHostGroup -Name "HostGroup01"
PS C:\> $HostProfile = Get-SCVMHostProfile -Name "HostProfile02"
PS C:\> New-SCVMHost -VMHostGroup $HostGroup -VMHostProfile $HostProfile -BMCAddress $NewPhysicalComputer.BMCAddress -BMCRunAsAccount $BMCRAA -BMCProtocol "IPMI" -SMBIOSGUID $NewPhysicalComputer.SMBIOSGUID -ComputerName "NewHost02" -ManagementAdapterMACAddress "00-18-8B-0A-4D-76" -LogicalNetwork "LogicalNetwork01" -Subnet "192.168.1.1/24" -IPAddress "192.168.1.101"

O primeiro comando obtém o objeto de conta Run As chamado BMCRunAsAccount e armazena o objeto na variável $BMCRAA.

O segundo comando descobre o computador com o endereço 10.10.0.1, utilizando a conta Run As armazenada em $BMCRAA e, em seguida, armazena o computador na variável $NewPhysicalComputer.

O terceiro comando obtém o objeto do grupo anfitrião chamado HostGroup01 e armazena o objeto na variável $HostGroup.

O quarto comando obtém o objeto de perfil do anfitrião chamado HostProfile02 e armazena o objeto na variável $HostProfile. HostProfile02 está configurado para alocar um endereço IP estático.

O último comando cria um hospedeiro a partir do computador físico armazenado em $NewPhysicalComputer utilizando o perfil de anfitrião armazenado em $HostProfile, dá-lhe o nome NewHost02, e configura o endereço MAC, IPAddress e sub-rede.

Exemplo 3: Recolocar um hospedeiro existente com um novo perfil de anfitrião

PS C:\> $BMCRaa = Get-SCRunAsAccount -Name "BMCRunAsAcct"
PS C:\> $OldHost = Get-SCVMHost "NewHost02"
PS C:\> $OldBMCIP = $OldHost.physicalmachine.BMCAddress
PS C:\> $OldBMCProtocol = $OldHost.physicalmachine.BMCType
PS C:\> $OldComputer = Find-SCComputer -BMCAddress $OldBMCIP -BMCRunAsAccount $BMCRAA -BMCProtocol $OldBMCProtocol
PS C:\> $OldGuid = $OldComputer.SMBIOSGUID
PS C:\> $OldAdapter = Get-SCVMHostNetworkAdapter -VMHost $OldHost
PS C:\> $OldMAC = $OldAdapter[0].macaddress
PS C:\> $OldRAA = Get-SCRunAsAccount -Name "RunAsAccount01"
PS C:\> Remove-SCVMHost $OldHost -Credential $OldRAA
PS C:\> $NewHostGroup = Get-SCVMHostGroup -Name "HostGroup01"
PS C:\> $NewHostProfile = Get-SCVMHostProfile -Name "HostProfile02"
PS C:\> New-SCVMHost -VMHostGroup $NewHostGroup -VMHostProfile $NewHostProfile  -BMCAddress $OldBMCIP -BMCRunAsAccount $BMcRAA -BMCProtocol $OldBMCProtocol -SMBIOSGUID $OldGUID -ManagementAdapterMACAddress $OldMAC -ComputerName "Computer01" -LogicalNetwork "LogicalNetwork01" -Subnet "192.168.0.1/24" -IPAddress "192.168.0.93"

O primeiro comando obtém o objeto de conta Run As chamado BMCRunAsAccount e armazena o objeto na variável $BMCRaa.

Os próximos oito comandos salvam propriedades do hospedeiro que vais recolocar.

O décimo comando remove o antigo hospedeiro do VMM.

O décimo primeiro comando recebe o objeto do grupo anfitrião chamado New HostGroup01 e armazena o objeto na variável $NewHostGroup.

O décimo segundo comando obtém o objeto de perfil do anfitrião chamado HostProfile02 e armazena o objeto na variável $NewHostProfile.

O último comando recoloca o antigo anfitrião utilizando as definições anteriores que identificam o hospedeiro, mas para um novo gorup do anfitrião (armazenado em $NewHostGroup) e com definições de perfil atualizadas (armazenadas em $NewHostProfile).

Parâmetros

-BMCAddress

Especifica, ou atualizações, o endereço do controlador de gestão de base (BMC) fora da banda para uma máquina física específica. Este pode ser um endereço IP, o nome de domínio totalmente qualificado (FQDN), ou o prefixo DNS (que normalmente é o mesmo nome do nome NetBIOS).

Normalmente, o endereço BMC e a sua ligação à rede são separados do endereço IP associado a um adaptador de rede padrão. Em alternativa, alguns computadores utilizam um adaptador de rede padrão para fornecer um único endereço para o BMC e para o adaptador de rede. No entanto, o endereço BMC tem uma porta única e é, portanto, unicamente identificável na rede.

  • Exemplo IPv4 formato: -BMCAddress "10.0.0.21"
  • Exemplo formato Ipv6: -BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829"
  • Exemplo FQDN formato: -BMCAddress "Computer01.Contoso.com"
  • Exemplo NetBIOS formato: -BMCAddress "Computer01"

Nota: Por predefinição, o VMM utiliza um endereço IP ou FQDN para o BMCAddress. No entanto, também é possível criar um módulo Windows PowerShell que lhe permita especificar outros tipos de endereços como endereço BMC.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-BMCCustomConfigurationProvider

Especifica, ou atualizações, um objeto de fornecedor de configuração para um controlador de gestão de rodapé (BMC). Um fornecedor de configuração é um plug-in para VMM que traduz comandos VMM PowerShell para chamadas API que são específicas de um tipo de controlador de gestão de rodapé. Deve utilizar este parâmetro com o BMCProtocol personalizado.

Type:ConfigurationProvider
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BMCPort

Especifica, ou atualizações, a porta de gestão de base (BMC) fora da banda para uma máquina física específica. Uma porta BMC também é conhecida como uma porta de processador de serviço. As portas por exemplo são 623 para IPMI e 443 para SMASH over WS-Man.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BMCProtocol

Especifica, ou atualizações, o protocolo que o VMM utiliza para comunicar com o controlador de gestão de base fora de banda (BMC). Os valores válidos são: IPMI, SMASH, Custom.

Um BMC (também conhecido como processador de serviço ou controlador de gestão) é um controlador especializado na placa-mãe de um servidor que age uma interface entre o software de gestão de hardware e sistema. Se a placa-mãe de uma máquina física incluir um BMC, quando a máquina está ligada (se está ligada ou ligada, e se um sistema operativo está ou não instalado), estão disponíveis informações sobre hardware do sistema e sobre o estado da saúde do hardware do sistema.

Formato de exemplo: -BMCProtocol "Custom"

Nota: O protocolo Personalizado requer que utilize o parâmetro BMCCustomConfigurationProvider .

Type:OutOfBandManagementType
Accepted values:None, IPMI, SMASH, Custom
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-BMCRunAsAccount

Especifica a conta Run As para utilizar com o dispositivo de gestão de rodapé (BMC).

Type:RunAsAccount
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-BypassADMachineAccountCheck

Indica que este cmdlet reutiliza uma conta de computador que já existe no Ative Directory. Por padrão, a New-SCVMHost verifica o Ative Directory para uma conta existente com o nome especificado para evitar a sobreescrita de contas de computador.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ComputerName

Especifica o nome de um computador que o VMM pode identificar exclusivamente na sua rede. Os valores aceitáveis para este parâmetro são:

  • FQDN
  • Endereço IPv4 ou IPv6
  • Nome NetBIOS
Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Description

Especifica uma descrição para o anfitrião VMM.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPAddress

Especifica um endereço IPv4 ou IPv6.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 as atribuições de rede.

Type:LogicalNetwork
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ManagementAdapterMACAddress

Especifica o endereço MAC do adaptador de rede física no computador que deve ser utilizado pelo servidor VMM para comunicar com este anfitrião.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Especifica o ID da ponta de otimização de desempenho e recursos (ponta PRO) que desencadeou esta ação. Este parâmetro permite-lhe auditar dicas PRO.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

Indica que o trabalho funciona assíncronamente para que o controlo volte imediatamente à concha de comando.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SMBiosGuid

Especifica o identificador globalmente único de Gestão de Sistemas BIOS (SMBIOS GUID) para um computador físico que está associado a um registo para aquele computador físico em VMM.

O SMBIOS define estruturas de dados e métodos de acesso que permitem ao utilizador ou aplicação armazenar e recuperar informações sobre hardware neste computador, como o nome do sistema, fabricante ou versão BIOS do sistema. O Windows obtém dados SMBIOS no arranque do sistema e disponibiliza esses dados aos programas.

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Subnet

Especifica uma sub-rede IP (IPv4 ou IPv6) na notação de encaminhamento de Inter-Domain sem classe (CIDR).

  • Formato de exemplo para uma sub-rede IPv4: 192.168.0.1/24
  • Formato de exemplo para uma sub-rede IPv6: FD4A:29CD:184F:3A2C::/64

Nota: Uma sub-rede IP não pode sobrepor-se a qualquer outra sub-rede num grupo de acolhimento ou grupos de acolhimento de crianças.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMHostConfig

Especifica um objeto de configuração física do computador.

Type:PhysicalComputerConfig
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VMHostGroup

Especifica um objeto de grupo de anfitriões de máquina virtual.

Type:HostGroup
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMHostProfile

Especifica um objeto de perfil de anfitrião de máquina virtual.

Type:PhysicalComputerProfile
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMMServer

Especifica um objeto de servidor VMM.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Saídas

Host

Este cmdlet devolve um objeto hospedeiro .

Notas

  • Requer um objeto de perfil do anfitrião, que pode ser recuperado usando o cmdlet Get-SCVMHostProfile .