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 .