New-SCVMHost
Crea un host VMM desde un equipo físico mediante las propiedades definidas en un 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
El cmdlet New-SCVMHost crea un host de Virtual Machine Manager (VMM) desde un equipo físico mediante las propiedades definidas en un perfil de host. El equipo físico debe tener un controlador fuera de banda.
Antes de crear un host, asegúrese de que se ha agregado un servidor PXE a VMM, se ha creado un perfil de host y se han agregado los archivos de controlador necesarios a la biblioteca. Nota: El servidor PXE que agregue a VMM debe estar en la misma subred que los equipos físicos que desea convertir en hosts de Hyper-V administrados.
Para obtener más información sobre los tipos de hosts admitidos por VMM, escriba Get-Help Add-SCVMHost -Detailed.
Ejemplos
Ejemplo 1: Creación de un host desde un equipo físico mediante un perfil de host basado en 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"El primer comando obtiene el objeto de cuenta de ejecución denominado BMCRunAsAcct y almacena el objeto en la variable $BMCRAA.
El segundo comando detecta el equipo físico con la dirección IP 10.10.0.1 mediante la cuenta de ejecución proporcionada en $BMCRAA. A continuación, almacena el equipo físico en la variable $NewPhysicalComputer.
El tercer comando obtiene el objeto de grupo host denominado HostGroup01 y almacena el objeto en la variable $HostGroup.
El cuarto comando obtiene el objeto de perfil de host denominado HostProfile01 y almacena el objeto en la variable $HostProfile. HostProfile01 está configurado para obtener una dirección IP a través del servicio DHCP.
El último comando crea un host desde el equipo físico almacenado en $NewPhysicalComputer mediante el perfil de host almacenado en $HostProfile y le asigna un nombre NewHost01.
Ejemplo 2: Creación de un host desde un equipo físico mediante un perfil de host estático basado en 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"El primer comando obtiene el objeto de cuenta de ejecución denominado BMCRunAsAccount y almacena el objeto en la variable $BMCRAA.
El segundo comando detecta el equipo con la dirección 10.10.0.1, mediante la cuenta de ejecución almacenada en $BMCRAA y, a continuación, almacena el equipo en la variable $NewPhysicalComputer.
El tercer comando obtiene el objeto de grupo host denominado HostGroup01 y almacena el objeto en la variable $HostGroup.
El cuarto comando obtiene el objeto de perfil de host denominado HostProfile02 y almacena el objeto en la variable $HostProfile. HostProfile02 está configurado para asignar una dirección IP estática.
El último comando crea un host desde el equipo físico almacenado en $NewPhysicalComputer mediante el perfil de host almacenado en $HostProfile, le asigna el nombre NewHost02 y configura la dirección MAC, IPAddress y subred.
Ejemplo 3: Reimplementación de un host existente con un nuevo 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"El primer comando obtiene el objeto de cuenta de ejecución denominado BMCRunAsAccount y almacena el objeto en la variable $BMCRaa.
Los ocho comandos siguientes guardan las propiedades del host que va a volver a implementar.
El décimo comando quita el host antiguo de VMM.
El undécimo comando obtiene el objeto de grupo host denominado New HostGroup01 y almacena el objeto en la variable $NewHostGroup.
El duodécimo comando obtiene el objeto de perfil de host denominado HostProfile02 y almacena el objeto en la variable $NewHostProfile.
El último comando vuelve a implementar el host anterior con la configuración anterior que identifica el host, pero en un nuevo host gorup (almacenado en $NewHostGroup) y con la configuración de perfil actualizada (almacenada en $NewHostProfile).
Parámetros
-BMCAddress
Especifica, o actualiza, la dirección del controlador de administración de placa base (BMC) fuera de banda para una máquina física específica. Puede tratarse de una dirección IP, el nombre de dominio completo (FQDN) o el prefijo DNS (que suele ser el mismo nombre que el nombre NetBIOS).
Normalmente, la dirección BMC y su conexión a la red son independientes de la dirección IP asociada a un adaptador de red estándar. Como alternativa, algunos equipos usan un adaptador de red estándar para proporcionar una única dirección para el BMC y para el adaptador de red. Sin embargo, la dirección BMC tiene un puerto único y, por tanto, es identificable de forma única en la red.
- Ejemplo de formato IPv4:
-BMCAddress "10.0.0.21" - Ejemplo de formato Ipv6:
-BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829" - Formato FQDN de ejemplo:
-BMCAddress "Computer01.Contoso.com" - Ejemplo de formato NetBIOS:
-BMCAddress "Computer01"
Nota: De forma predeterminada, VMM usa una dirección IP o un FQDN para BMCAddress. Sin embargo, también es posible crear un módulo de Windows PowerShell que le permita especificar otros tipos de direcciones como dirección BMC.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BMCCustomConfigurationProvider
Especifica, o actualiza, un objeto de proveedor de configuración para un controlador de administración de placa base (BMC). Un proveedor de configuración es un complemento de VMM que traduce comandos de PowerShell de VMM a llamadas API específicas de un tipo de controlador de administración de placa base. Debe usar este parámetro con el BMCProtocol personalizado.
| Type: | ConfigurationProvider |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BMCPort
Especifica, o actualiza, el puerto del controlador de administración de placa base (BMC) fuera de banda para una máquina física específica. Un puerto BMC también se conoce como puerto de procesador de servicios. Los puertos predeterminados de ejemplo son 623 para IPMI y 443 para SMASH a través de WS-Man.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BMCProtocol
Especifica, o actualiza, el protocolo que VMM usa para comunicarse con el controlador de administración de placa base fuera de banda (BMC). Los valores válidos son: IPMI, SMASH, Custom.
Un BMC (también conocido como procesador de servicios o controlador de administración) es un controlador especializado en la placa base de un servidor que actúa como una interfaz entre el hardware y el software de administración del sistema. Si la placa base de una máquina física incluye un BMC, cuando la máquina está conectada (ya sea apagada o apagada, y si está instalado o no un sistema operativo), la información sobre el hardware del sistema y el estado de ese estado de hardware del sistema está disponible.
Formato de ejemplo: -BMCProtocol "Custom"
Nota: El protocolo personalizado requiere que use el 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 la cuenta de ejecución que se va a usar con el dispositivo del controlador de administración de placa base (BMC).
| Type: | RunAsAccount |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BypassADMachineAccountCheck
Indica que este cmdlet reutiliza una cuenta de equipo que ya existe en Active Directory. De forma predeterminada, New-SCVMHost comprueba Active Directory en busca de una cuenta existente con el nombre especificado para evitar sobrescribir cuentas de equipo.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ComputerName
Especifica el nombre de un equipo que VMM puede identificar de forma única en su red. Los valores permitidos para este parámetro son los siguientes:
- FQDN
- Dirección IPv4 o IPv6
- Nombre de NetBIOS
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Especifica una descripción para el host VMM.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IPAddress
Especifica una dirección IPv4 o IPv6.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Especifica que se realiza un seguimiento del progreso del trabajo y que se almacena en la variable cuyo nombre indica este parámetro.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LogicalNetwork
Especifica una red lógica. Una red lógica es una agrupación con nombre de subredes IP y VLAN que se usan para organizar y simplificar las asignaciones de red.
| Type: | LogicalNetwork |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ManagementAdapterMACAddress
Especifica la dirección MAC del adaptador de red físico en el equipo que va a usar el servidor VMM para comunicarse con este host.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Especifica el identificador de la sugerencia de optimización de recursos y rendimiento (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar sugerencias pro.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva inmediatamente al shell de comandos.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SMBiosGuid
Especifica el identificador único global del BIOS de administración del sistema (GUID de SMBIOS) para un equipo físico asociado a un registro para ese equipo físico en VMM.
SMBIOS define estructuras de datos y métodos de acceso que permiten a un usuario o aplicación almacenar y recuperar información sobre el hardware en este equipo, como el nombre del sistema, el fabricante o la versión del BIOS del sistema. Windows obtiene datos SMBIOS al inicio del sistema y hace que los datos estén disponibles para los programas.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Subnet
Especifica una subred IP (IPv4 o IPv6) en notación de enrutamiento de Inter-Domain sin clases (CIDR).
- Formato de ejemplo para una subred IPv4:
192.168.0.1/24 - Formato de ejemplo para una subred IPv6:
FD4A:29CD:184F:3A2C::/64
Nota: Una subred IP no se puede superponer con ninguna otra subred de un grupo host o grupos host secundarios.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMHostConfig
Especifica un objeto de configuración de equipo físico.
| Type: | PhysicalComputerConfig |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMHostGroup
Especifica un objeto de grupo host de máquina virtual.
| Type: | HostGroup |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMHostProfile
Especifica un 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 un objeto de servidor VMM.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Salidas
Host
Este cmdlet devuelve un objeto Host .
Notas
- Requiere un objeto de perfil de host, que se puede recuperar mediante el cmdlet Get-SCVMHostProfile .