New-SCVMHost
Crea un host VMM da un computer fisico usando le proprietà definite in un profilo host.
Sintassi
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>]Descrizione
Il cmdlet New-SCVMHost
Prima di creare un host, assicurarsi che un server PXE sia stato aggiunto a VMM, sia stato creato un profilo host e che siano stati aggiunti eventuali file driver necessari alla libreria. Nota: il server PXE aggiunto a VMM deve trovarsi nella stessa subnet dei computer fisici da convertire in host Hyper-V gestiti.
Per altre informazioni sui tipi di host supportati da VMM, digitare Get-Help Add-SCVMHost -Detailed.
Esempio
Esempio 1: Creare un host da un computer fisico usando un profilo host basato su 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"Il primo comando ottiene l'oggetto account RunAs denominato BMCRunAsAcct e archivia l'oggetto nella variabile $BMCRAA.
Il secondo comando individua il computer fisico con l'indirizzo IP 10.10.0.1 usando l'account RunAs fornito in $BMCRAA. Archivia quindi il computer fisico nella variabile $NewPhysicalComputer.
Il terzo comando ottiene l'oggetto gruppo host denominato HostGroup01 e archivia l'oggetto nella variabile $HostGroup.
Il quarto comando ottiene l'oggetto profilo host denominato HostProfile01 e archivia l'oggetto nella variabile $HostProfile. HostProfile01 è configurato per ottenere un indirizzo IP tramite il servizio DHCP.
L'ultimo comando crea un host dal computer fisico archiviato in $NewPhysicalComputer usando il profilo host archiviato in $HostProfile e assegna un nome a NewHost01.
Esempio 2: Creare un host da un computer fisico usando un profilo host basato su IP statico
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"Il primo comando ottiene l'oggetto account RunAs denominato BMCRunAsAccount e archivia l'oggetto nella variabile $BMCRAA.
Il secondo comando individua il computer con l'indirizzo 10.10.0.1, usando l'account RunAs archiviato in $BMCRAA e quindi archivia il computer nella variabile $NewPhysicalComputer.
Il terzo comando ottiene l'oggetto gruppo host denominato HostGroup01 e archivia l'oggetto nella variabile $HostGroup.
Il quarto comando ottiene l'oggetto profilo host denominato HostProfile02 e archivia l'oggetto nella variabile $HostProfile. HostProfile02 è configurato per allocare un indirizzo IP statico.
L'ultimo comando crea un host dal computer fisico archiviato in $NewPhysicalComputer usando il profilo host archiviato in $HostProfile, assegna il nome NewHost02 e configura l'indirizzo MAC, IPAddress e la subnet.
Esempio 3: Ridistribuire un host esistente con un nuovo profilo 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"Il primo comando ottiene l'oggetto account RunAs denominato BMCRunAsAccount e archivia l'oggetto nella variabile $BMCRaa.
Gli otto comandi successivi salvano le proprietà dall'host che si intende ridistribuire.
Il decimo comando rimuove l'host precedente da VMM.
L'undicesimo comando ottiene l'oggetto gruppo host denominato New HostGroup01 e archivia l'oggetto nella variabile $NewHostGroup.
Il dodicesimo comando ottiene l'oggetto profilo host denominato HostProfile02 e archivia l'oggetto nella variabile $NewHostProfile.
L'ultimo comando ridistribuisce l'host precedente usando le impostazioni precedenti che identificano l'host, ma in un nuovo gorup host (archiviato in $NewHostGroup) e con impostazioni del profilo aggiornate (archiviate in $NewHostProfile).
Parametri
-BMCAddress
Specifica o aggiorna l'indirizzo BMC (Baseboard Management Controller) fuori banda per un computer fisico specifico. Potrebbe trattarsi di un indirizzo IP, del nome di dominio completo (FQDN) o del prefisso DNS (che in genere è lo stesso nome del nome NetBIOS).
In genere, l'indirizzo BMC e la relativa connessione alla rete sono separati dall'indirizzo IP associato a una scheda di rete standard. In alternativa, alcuni computer usano una scheda di rete standard per fornire un singolo indirizzo per BMC e per la scheda di rete. Tuttavia, l'indirizzo BMC ha una porta univoca ed è quindi identificabile in modo univoco nella rete.
- Formato IPv4 di esempio:
-BMCAddress "10.0.0.21" - Formato Ipv6 di esempio:
-BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829" - Formato FQDN di esempio:
-BMCAddress "Computer01.Contoso.com" - Formato NetBIOS di esempio:
-BMCAddress "Computer01"
Nota: per impostazione predefinita, VMM usa un indirizzo IP o un FQDN per BMCAddress. Tuttavia, è anche possibile creare un modulo di Windows PowerShell che consente di specificare altri tipi di indirizzi come indirizzo BMC.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-BMCCustomConfigurationProvider
Specifica, o aggiorna, un oggetto provider di configurazione per un controller di gestione della lavagna di base ( BMC). Un provider di configurazione è un plug-in in VMM che converte i comandi di PowerShell VMM in chiamate API specifiche di un tipo di controller di gestione della lavagna base. È consigliabile usare questo parametro con custom BMCProtocol.
| Tipo: | ConfigurationProvider |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-BMCPort
Specifica, o aggiorna, la porta BMC (Baseboard Management Controller) fuori banda per un computer fisico specifico. Una porta BMC è nota anche come porta del processore di servizi. Le porte predefinite di esempio sono 623 per IPMI e 443 per SMASH su WS-Man.
| Tipo: | UInt32 |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-BMCProtocol
Specifica, o aggiorna, il protocollo usato da VMM per comunicare con il controller di gestione della lavagna di base fuori banda (BMC). I valori validi sono: IPMI, SMASH, Custom.
Un BMC (noto anche come controller di gestione o processore di servizi) è un controller specializzato nella scheda madre di un server che agisce un'interfaccia tra il software di gestione hardware e di sistema. Se la scheda madre di un computer fisico include un BMC, quando il computer è collegato (se è spento o acceso e se è installato o meno un sistema operativo), informazioni sull'hardware del sistema e sullo stato di tale integrità hardware del sistema è disponibile.
Formato di esempio: -BMCProtocol "Custom"
Nota: il protocollo personalizzato richiede l'uso del parametro BMCCustomConfigurationProvider
| Tipo: | OutOfBandManagementType |
| Valori accettati: | None, IPMI, SMASH, Custom |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-BMCRunAsAccount
Specifica l'account RunAs da usare con il dispositivo BMC (BaseBoard Management Controller).
| Tipo: | RunAsAccount |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-BypassADMachineAccountCheck
Indica che questo cmdlet riutilizza un account computer già esistente in Active Directory. Per impostazione predefinita, New-SCVMHost controlla Active Directory per un account esistente con il nome specificato per impedire la sovrascrittura degli account computer.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ComputerName
Specifica il nome di un computer che VMM può identificare in modo univoco nella rete. I valori accettabili per questo parametro sono:
- FQDN
- Indirizzo IPv4 o IPv6
- Nome NetBIOS
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Description
Specifica una descrizione per l'host VMM.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-IPAddress
Specifica un indirizzo IPv4 o IPv6.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-JobVariable
Specifica che lo stato del processo viene rilevato e archiviato nella variabile denominata da questo parametro.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-LogicalNetwork
Specifica una rete logica. Una rete logica è un raggruppamento denominato di subnet IP e VLAN usate per organizzare e semplificare le assegnazioni di rete.
| Tipo: | LogicalNetwork |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ManagementAdapterMACAddress
Specifica l'indirizzo MAC della scheda di rete fisica nel computer che deve essere utilizzato dal server VMM per comunicare con questo host.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-PROTipID
Specifica l'ID del suggerimento per le prestazioni e l'ottimizzazione risorse (suggerimento PRO) che ha attivato questa azione. Questo parametro consente di controllare i suggerimenti pro.
| Tipo: | Guid |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-RunAsynchronously
Indica che il processo viene eseguito in modo asincrono in modo che il controllo torni immediatamente alla shell dei comandi.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-SMBiosGuid
Specifica l'identificatore univoco globale del BIOS di gestione del sistema (GUID SMBIOS) per un computer fisico associato a un record per il computer fisico in VMM.
SMBIOS definisce strutture di dati e metodi di accesso che consentono a un utente o a un'applicazione di archiviare e recuperare informazioni sull'hardware in questo computer, ad esempio il nome del sistema, del produttore o della versione bios di sistema. Windows ottiene i dati SMBIOS all'avvio del sistema e rende tali dati disponibili per i programmi.
| Tipo: | Guid |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Subnet
Specifica una subnet IP (IPv4 o IPv6) nella notazione CIDR (Classless Inter-Domain Routing).
- Formato di esempio per una subnet IPv4:
192.168.0.1/24 - Formato di esempio per una subnet IPv6:
FD4A:29CD:184F:3A2C::/64
Nota: una subnet IP non può sovrapporsi a qualsiasi altra subnet in un gruppo host o in gruppi host figlio.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-VMHostConfig
Specifica un oggetto di configurazione computer fisico.
| Tipo: | PhysicalComputerConfig |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-VMHostGroup
Specifica un oggetto gruppo host macchina virtuale.
| Tipo: | HostGroup |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-VMHostProfile
Specifica un oggetto profilo host della macchina virtuale.
| Tipo: | PhysicalComputerProfile |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-VMMServer
Specifica un oggetto server VMM.
| Tipo: | ServerConnection |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
Output
Host
Questo cmdlet restituisce un oggetto host
Note
- Richiede un oggetto profilo host, che può essere recuperato usando il cmdlet get-SCVMHostProfile
.