New-SCVMHost
Cria um host VMM de um computador físico usando as propriedades definidas em um perfil de host.
Sintaxe
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 host VMM (Virtual Machine Manager) de um computador físico usando as propriedades definidas em um perfil de host. O computador físico deve ter um controlador fora de banda.
Antes de criar um host, verifique se um servidor PXE foi adicionado ao VMM, um perfil de host foi criado e todos os arquivos de driver necessários foram adicionados à biblioteca. Observação: o servidor PXE que você adiciona ao VMM deve estar na mesma sub-rede que os computadores físicos que você deseja converter em hosts Hyper-V gerenciados.
Para obter mais informações sobre os tipos de hosts compatíveis com o VMM, digite Get-Help Add-SCVMHost -Detailed.
Exemplos
Exemplo 1: criar um host de um computador físico usando um perfil de host 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 Executar como chamado BMCRunAsAcct e armazena o objeto na variável $BMCRAA.
O segundo comando descobre o computador físico com o endereço IP 10.10.0.1 usando a conta Executar como fornecida no $BMCRAA. Em seguida, armazena o computador físico na variável $NewPhysicalComputer.
O terceiro comando obtém o objeto de grupo de host chamado HostGroup01 e armazena o objeto na variável $HostGroup.
O quarto comando obtém o objeto de perfil de host chamado HostProfile01 e armazena o objeto na variável $HostProfile. HostProfile01 está configurado para obter um endereço IP por meio do serviço DHCP.
O último comando cria um host do computador físico armazenado em $NewPhysicalComputer usando o perfil de host armazenado em $HostProfile e o nomeia NewHost01.
Exemplo 2: criar um host de um computador físico usando um perfil de host 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 Executar como chamado BMCRunAsAccount e armazena o objeto na variável $BMCRAA.
O segundo comando descobre o computador com o endereço 10.10.0.1, usando a conta Executar como armazenada em $BMCRAA e armazena o computador na variável $NewPhysicalComputer.
O terceiro comando obtém o objeto de grupo de host chamado HostGroup01 e armazena o objeto na variável $HostGroup.
O quarto comando obtém o objeto de perfil de host 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 host do computador físico armazenado em $NewPhysicalComputer usando o perfil de host armazenado em $HostProfile, fornece o nome NewHost02 e configura o endereço MAC, o IPAddress e a sub-rede.
Exemplo 3: reimplantar um host existente com um novo perfil de host
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 Executar como chamado BMCRunAsAccount e armazena o objeto na variável $BMCRaa.
Os próximos oito comandos salvam propriedades do host que você vai reimplantar.
O décimo comando remove o host antigo do VMM.
O décimo primeiro comando obtém o objeto de grupo de host chamado New HostGroup01 e armazena o objeto na variável $NewHostGroup.
O décimo segundo comando obtém o objeto de perfil de host chamado HostProfile02 e armazena o objeto na variável $NewHostProfile.
O último comando reimplanta o host antigo usando as configurações anteriores que identificam o host, mas para um novo gorup de host (armazenado em $NewHostGroup) e com configurações de perfil atualizadas (armazenadas em $NewHostProfile).
Parâmetros
-BMCAddress
Especifica ou atualiza o endereço BMC (controlador de gerenciamento de placa base) fora da banda para um computador físico específico. Pode ser um endereço IP, o FQDN (nome de domínio totalmente qualificado) ou o prefixo DNS (que geralmente é o mesmo nome que o nome NetBIOS).
Normalmente, o endereço BMC e sua conexão com a rede são separados do endereço IP associado a um adaptador de rede padrão. Como alternativa, alguns computadores usam 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 exclusiva e, portanto, é exclusivamente identificável na rede.
- Formato IPv4 de exemplo:
-BMCAddress "10.0.0.21" - Formato ipv6 de exemplo:
-BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829" - Exemplo de formato FQDN:
-BMCAddress "Computer01.Contoso.com" - Exemplo de formato NetBIOS:
-BMCAddress "Computer01"
Observação: por padrão, o VMM usa um endereço IP ou FQDN para o BMCAddress. No entanto, também é possível criar um módulo do Windows PowerShell que permite especificar outros tipos de endereços como o endereço BMC.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-BMCCustomConfigurationProvider
Especifica ou atualiza um objeto de provedor de configuração para um BMC (controlador de gerenciamento de placa base). Um provedor de configuração é um plug-in para o VMM que converte comandos do VMM PowerShell em chamadas de API específicas para um tipo de controlador de gerenciamento de placa base. Você deve usar esse parâmetro com o BMCProtocol personalizado.
| Tipo: | ConfigurationProvider |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-BMCPort
Especifica ou atualiza a porta BMC (controlador de gerenciamento de placa base fora de banda) para um computador físico específico. Uma porta BMC também é conhecida como uma porta de processador de serviço. As portas padrão de exemplo são 623 para IPMI e 443 para SMASH em relação ao WS-Man.
| Tipo: | UInt32 |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-BMCProtocol
Especifica ou atualiza o protocolo que o VMM usa para se comunicar com o BMC (controlador de gerenciamento de placa base fora de banda). Os valores válidos são: IPMI, SMASH, Custom.
Um BMC (também conhecido como um processador de serviço ou controlador de gerenciamento) é um controlador especializado na placa-mãe de um servidor que atua em uma interface entre o hardware e o software de gerenciamento do sistema. Se a placa-mãe de um computador físico incluir um BMC, quando o computador estiver conectado (se ele estiver desligado ou ligado e se um sistema operacional estiver instalado ou não), informações sobre o hardware do sistema e o estado dessa integridade do hardware do sistema estarão disponíveis.
Formato de exemplo: -BMCProtocol "Custom"
Observação: o protocolo Personalizado requer que você use o parâmetro BMCCustomConfigurationProvider.
| Tipo: | OutOfBandManagementType |
| Valores aceitos: | None, IPMI, SMASH, Custom |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-BMCRunAsAccount
Especifica a conta Executar como a ser usada com o dispositivo BMC (controlador de gerenciamento de placa base).
| Tipo: | RunAsAccount |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-BypassADMachineAccountCheck
Indica que esse cmdlet reutiliza uma conta de computador que já existe no Active Directory. Por padrão, New-SCVMHost verifica se há uma conta existente no Active Directory com o nome especificado para impedir a substituição de contas de computador.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ComputerName
Especifica o nome de um computador que o VMM pode identificar exclusivamente em sua rede. Os valores aceitáveis para este parâmetro são:
- FQDN
- Endereço IPv4 ou IPv6
- Nome do NetBIOS
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Description
Especifica uma descrição para o host do VMM.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-IPAddress
Especifica um endereço IPv4 ou IPv6.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-JobVariable
Especifica que o progresso do trabalho é acompanhado e armazenado na variável nomeada por esse parâmetro.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | 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 |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ManagementAdapterMACAddress
Especifica o endereço MAC do adaptador de rede física no computador que deve ser usado pelo servidor VMM para se comunicar com esse host.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-PROTipID
Especifica a ID da dica de Otimização de Recursos e Desempenho (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.
| Tipo: | Guid |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-RunAsynchronously
Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-SMBiosGuid
Especifica o IDENTIFICADOR global exclusivo do BIOS (SMBIOS GUID) do System Management para um computador físico associado a um registro para esse computador físico no VMM.
O SMBIOS define estruturas de dados e métodos de acesso que permitem que um usuário ou aplicativo armazene e recupere informações sobre hardware neste computador, como o nome do sistema, do fabricante ou da versão do BIOS do sistema. O Windows obtém dados SMBIOS na inicialização do sistema e disponibiliza esses dados para programas.
| Tipo: | Guid |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Subnet
Especifica uma sub-rede IP (IPv4 ou IPv6) na notação cidr (roteamento de Inter-Domain sem classe).
- 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
Observação: uma sub-rede IP não pode se sobrepor a nenhuma outra sub-rede em um grupo de hosts ou grupos de host filho.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-VMHostConfig
Especifica um objeto de configuração de computador físico.
| Tipo: | PhysicalComputerConfig |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-VMHostGroup
Especifica um objeto de grupo de host de máquina virtual.
| Tipo: | HostGroup |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-VMHostProfile
Especifica um objeto de perfil de host de máquina virtual.
| Tipo: | PhysicalComputerProfile |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-VMMServer
Especifica um objeto de servidor do VMM.
| Tipo: | ServerConnection |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
Saídas
Host
Esse cmdlet retorna um objeto Host.
Observações
- Requer um objeto de perfil de host, que pode ser recuperado usando o cmdlet Get-SCVMHostProfile
.