New-SCVMHost
Crée un hôte VMM à partir d’un ordinateur physique à l’aide des propriétés définies dans un profil hôte.
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
L’applet de commande New-SCVMHost crée un hôte VMM (Virtual Machine Manager) à partir d’un ordinateur physique à l’aide des propriétés définies dans un profil hôte. L’ordinateur physique doit avoir un contrôleur hors bande.
Avant de créer un hôte, vérifiez qu’un serveur PXE a été ajouté à VMM, un profil hôte a été créé et tous les fichiers de pilotes nécessaires ont été ajoutés à la bibliothèque. Remarque : le serveur PXE que vous ajoutez à VMM doit se trouver dans le même sous-réseau que les ordinateurs physiques que vous souhaitez convertir en hôtes Hyper-V gérés.
Pour plus d’informations sur les types d’hôtes pris en charge par VMM, tapez Get-Help Add-SCVMHost -Detailed.
Exemples
Exemple 1 : Créer un hôte à partir d’un ordinateur physique à l’aide d’un profil hôte basé sur 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"La première commande obtient l’objet de compte d’identification nommé BMCRunAsAcct et stocke l’objet dans la variable $BMCRAA.
La deuxième commande découvre l’ordinateur physique avec l’adresse IP de 10.10.0.1 à l’aide du compte d’identification fourni dans $BMCRAA. Il stocke ensuite l’ordinateur physique dans la variable $NewPhysicalComputer.
La troisième commande obtient l’objet de groupe hôte nommé HostGroup01 et stocke l’objet dans la variable $HostGroup.
La quatrième commande obtient l’objet de profil hôte nommé HostProfile01 et stocke l’objet dans la variable $HostProfile. HostProfile01 est configuré pour obtenir une adresse IP via le service DHCP.
La dernière commande crée un hôte à partir de l’ordinateur physique stocké dans $NewPhysicalComputer à l’aide du profil hôte stocké dans $HostProfile et le nomme NewHost01.
Exemple 2 : Créer un hôte à partir d’un ordinateur physique à l’aide d’un profil hôte basé sur IP statique
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"La première commande obtient l’objet de compte d’identification nommé BMCRunAsAccount et stocke l’objet dans la variable $BMCRAA.
La deuxième commande découvre l’ordinateur avec l’adresse 10.10.0.1, à l’aide du compte d’identification stocké dans $BMCRAA, puis stocke l’ordinateur dans la variable $NewPhysicalComputer.
La troisième commande obtient l’objet de groupe hôte nommé HostGroup01 et stocke l’objet dans la variable $HostGroup.
La quatrième commande obtient l’objet de profil hôte nommé HostProfile02 et stocke l’objet dans la variable $HostProfile. HostProfile02 est configuré pour allouer une adresse IP statique.
La dernière commande crée un hôte à partir de l’ordinateur physique stocké dans $NewPhysicalComputer à l’aide du profil hôte stocké dans $HostProfile, lui donne le nom NewHost02 et configure l’adresse MAC, IPAddress et le sous-réseau.
Exemple 3 : Redéployer un hôte existant avec un nouveau profil hôte
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"La première commande obtient l’objet de compte d’identification nommé BMCRunAsAccount et stocke l’objet dans la variable $BMCRaa.
Les huit commandes suivantes enregistrent les propriétés de l’hôte que vous allez redéployer.
La dixième commande supprime l’ancien hôte de VMM.
La onzee commande obtient l’objet de groupe hôte nommé New HostGroup01 et stocke l’objet dans la variable $NewHostGroup.
La deuxième commande obtient l’objet de profil hôte nommé HostProfile02 et stocke l’objet dans la variable $NewHostProfile.
La dernière commande redéploie l’ancien hôte à l’aide des paramètres précédents qui identifient l’hôte, mais vers un nouveau gorup hôte (stocké dans $NewHostGroup) et avec les paramètres de profil mis à jour (stockés dans $NewHostProfile).
Paramètres
-BMCAddress
Spécifie ou met à jour l’adresse BMC (Out-Of-Band Baseboard Management Controller) pour une machine physique spécifique. Il peut s’agir d’une adresse IP, du nom de domaine complet (FQDN) ou du préfixe DNS (qui est généralement le même nom que le nom NetBIOS).
En règle générale, l’adresse BMC et sa connexion au réseau sont distinctes de l’adresse IP associée à une carte réseau standard. Par ailleurs, certains ordinateurs utilisent une carte réseau standard pour fournir une adresse unique pour la console BMC et pour la carte réseau. Toutefois, l’adresse BMC a un port unique et est donc identifiable de manière unique sur le réseau.
- Exemple de format IPv4 :
-BMCAddress "10.0.0.21" - Exemple de format Ipv6 :
-BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829" - Exemple de format FQDN :
-BMCAddress "Computer01.Contoso.com" - Exemple de format NetBIOS :
-BMCAddress "Computer01"
Remarque : par défaut, VMM utilise une adresse IP ou un nom de domaine complet pour BMCAddress. Toutefois, il est également possible de créer un module Windows PowerShell qui vous permet de spécifier d’autres types d’adresses comme adresse BMC.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BMCCustomConfigurationProvider
Spécifie ou met à jour un objet fournisseur de configuration pour un contrôleur de gestion de tableau de base (BMC). Un fournisseur de configuration est un plug-in à VMM qui traduit les commandes PowerShell VMM en appels d’API spécifiques à un type de contrôleur de gestion de tableau de base. Vous devez utiliser ce paramètre avec le BMCProtocol personnalisé.
| Type: | ConfigurationProvider |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BMCPort
Spécifie, ou met à jour, le port BMC (Out-Of-Band Baseboard Management Controller) pour une machine physique spécifique. Un port BMC est également appelé port de processeur de service. Les exemples de ports par défaut sont 623 pour IPMI et 443 pour SMASH sur WS-Man.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BMCProtocol
Spécifie ou met à jour le protocole que VMM utilise pour communiquer avec le contrôleur de gestion de carte de base de base hors bande (BMC). Les valeurs valides sont : IPMI, SMASH, Custom.
Un contrôleur BMC (également appelé processeur de service ou contrôleur de gestion) est un contrôleur spécialisé sur la carte mère d’un serveur qui agit une interface entre le logiciel de gestion du matériel et du système. Si la carte mère d’une machine physique comprend une console BMC, lorsque la machine est branchée (qu’elle soit désactivée ou activée, et si un système d’exploitation est installé), des informations sur le matériel système et l’état de cette intégrité matérielle du système sont disponibles.
Exemple de format : -BMCProtocol "Custom"
Remarque : Le protocole personnalisé nécessite que vous utilisiez le paramètre 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
Spécifie le compte d’identification à utiliser avec l’appareil BMC (Baseboard Management Controller).
| Type: | RunAsAccount |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BypassADMachineAccountCheck
Indique que cette applet de commande réutilise un compte d’ordinateur qui existe déjà dans Active Directory. Par défaut, New-SCVMHost vérifie Active Directory pour un compte existant avec le nom spécifié pour empêcher l’remplacement des comptes d’ordinateur.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ComputerName
Spécifie le nom d’un ordinateur que VMM peut identifier de manière unique sur votre réseau. Les valeurs valides pour ce paramètre sont :
- FQDN
- Adresse IPv4 ou IPv6
- Nom NetBIOS
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Spécifie une description pour l’hôte VMM.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IPAddress
Spécifie une adresse IPv4 ou IPv6.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Spécifie que la progression des travaux est suivie et stockée dans la variable nommée par ce paramètre.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LogicalNetwork
Spécifie un réseau logique. Un réseau logique est un regroupement nommé de sous-réseaux IP et de réseaux virtuels utilisés pour organiser et simplifier les attributions de réseau.
| Type: | LogicalNetwork |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ManagementAdapterMACAddress
Spécifie l’adresse MAC de la carte réseau physique sur l’ordinateur à utiliser par le serveur VMM pour communiquer avec cet hôte.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Spécifie l’ID du conseil d’optimisation des performances et des ressources qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils PRO.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Indique que le travail s’exécute de manière asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SMBiosGuid
Spécifie l’identificateur global unique du BIOS de gestion du système (SMBIOS GUID) pour un ordinateur physique associé à un enregistrement pour cet ordinateur physique dans VMM.
SMBIOS définit les structures de données et les méthodes d’accès qui permettent à un utilisateur ou à une application de stocker et de récupérer des informations sur le matériel sur cet ordinateur, telles que le nom du système, du fabricant ou de la version du BIOS système. Windows obtient les données SMBIOS au démarrage du système et met ces données à la disposition des programmes.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Subnet
Spécifie un sous-réseau IP (IPv4 ou IPv6) dans la notation Inter-Domain routage (CIDR) sans classe.
- Exemple de format pour un sous-réseau IPv4 :
192.168.0.1/24 - Exemple de format pour un sous-réseau IPv6 :
FD4A:29CD:184F:3A2C::/64
Remarque : un sous-réseau IP ne peut pas chevaucher un autre sous-réseau dans un groupe hôte ou des groupes hôtes enfants.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMHostConfig
Spécifie un objet de configuration d’ordinateur physique.
| Type: | PhysicalComputerConfig |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMHostGroup
Spécifie un objet groupe hôte d'ordinateurs virtuels.
| Type: | HostGroup |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMHostProfile
Spécifie un objet de profil hôte de machine virtuelle.
| Type: | PhysicalComputerProfile |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMMServer
Spécifie un objet serveur VMM.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Sorties
Host
Cette applet de commande retourne un objet Host .
Notes
- Nécessite un objet de profil hôte, qui peut être récupéré à l’aide de l’applet de commande Get-SCVMHostProfile .