New-SCVMHost
Cria um host do VMM de um computador físico usando as propriedades definidas em um perfil de host.
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 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 Gerenciados do Hyper-V.
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 em $BMCRAA. Em seguida, armazena o computador físico na variável $NewPhysicalComputer.
O terceiro comando obtém o objeto do grupo de hosts 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 nomeia-o como 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 do grupo de hosts 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 do grupo de hosts 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 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.
- Exemplo de formato IPv4:
-BMCAddress "10.0.0.21"
- Exemplo de formato Ipv6:
-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 Windows PowerShell que permite que você especifique outros tipos de endereços como o endereço BMC.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BMCCustomConfigurationProvider
Especifica ou atualiza um objeto de provedor de configuração para um BMC (controlador de gerenciamento de quadro de base). Um provedor de configuração é um plug-in para o VMM que converte comandos do PowerShell do VMM para chamadas à API específicas para um tipo de controlador de gerenciamento de quadro de base. Você deve usar esse 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 a porta BMC (controlador de gerenciamento de placa base) fora da banda para um computador físico específico. Uma porta BMC também é conhecida como uma porta do processador de serviço. As portas padrão de exemplo são 623 para IPMI e 443 para SMASH sobre WS-Man.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 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 está instalado ou não), informações sobre o hardware do sistema e o estado dessa integridade de hardware do sistema estarão disponíveis.
Formato de exemplo: -BMCProtocol "Custom"
Observação: o protocolo Personalizado exige que você use 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 Executar como a ser usada com o dispositivo BMC (controlador de gerenciamento de quadro de base).
Type: | RunAsAccount |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BypassADMachineAccountCheck
Indica que esse cmdlet reutiliza uma conta de computador que já existe no Active Directory. Por padrão, New-SCVMHost verifica o Active Directory para obter uma conta existente com o nome especificado para impedir a substituição 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 em sua rede. Os valores aceitáveis para esse 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 host do 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 andamento do trabalho é controlado e armazenado na variável nomeada por esse 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 usados para organizar e simplificar 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ísico no computador que será usado pelo servidor do VMM para se comunicar com esse host.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PROTipID
Especifica a ID da dica de Desempenho e Otimização de Recursos (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsynchronously
Indica que o trabalho é executado de forma assíncrona para que o controle retorne imediatamente ao shell de comando.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 bios do sistema. O Windows obtém dados SMBIOS na inicialização do sistema e disponibiliza esses dados para 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 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 hosts filho.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMHostConfig
Especifica um objeto de configuração de computador físico.
Type: | PhysicalComputerConfig |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMHostGroup
Especifica um objeto de grupo de host 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 host 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 do VMM.
Type: | ServerConnection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .