Condividi tramite

New-SCVMHost

  • Riferimento
Modulo:
VirtualMachineManager

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 crea un host di Virtual Machine Manager (VMM) da un computer fisico usando le proprietà definite in un profilo host. Il computer fisico deve avere un controller fuori banda.

Prima di creare un host, assicurarsi che sia stato aggiunto un server PXE a VMM, sia stato creato un profilo host e siano stati aggiunti i file di 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 del 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 lo assegna 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 del 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.

I seguenti otto comandi salvano le proprietà dall'host che si intende ridistribuire.

Il decimo comando rimuove l'host precedente da VMM.

Il comando undicesimo ottiene l'oggetto gruppo host denominato New HostGroup01 e archivia l'oggetto nella variabile $NewHostGroup.

Il comando twelfth 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 le impostazioni del profilo aggiornate (archiviate in $NewHostProfile).

Parametri

-BMCAddress

Specifica o aggiorna l'indirizzo BMC (Out-of-Band Baseboard Management Controller) per un computer fisico specifico. Questo potrebbe essere un indirizzo IP, il nome di dominio completo (FQDN) o il 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 nome di dominio completo per BMCAddress. Tuttavia, è anche possibile creare un modulo Windows PowerShell che consente di specificare altri tipi di indirizzi come indirizzo BMC.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-BMCCustomConfigurationProvider

Specifica o aggiorna, un oggetto provider di configurazione per un controller di gestione della scheda di base (BMC). Un provider di configurazione è un plug-in a VMM che converte i comandi di PowerShell VMM alle chiamate API specifiche di un tipo di controller di gestione della scheda di base. È consigliabile usare questo parametro con custom BMCProtocol.

Type:ConfigurationProvider
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BMCPort

Specifica o aggiorna la porta BMC (Baseboard Management Controller) out-of-band 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.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BMCProtocol

Specifica o aggiorna il protocollo usato da VMM per comunicare con il controller di gestione della baseboard out-of-band (BMC). I valori validi sono: IPMI, SMASH, Custom.

Un BMC (noto anche come controller di gestione o processore di servizi) è un controller specializzato sulla scheda madre di un server che agisce un'interfaccia tra l'hardware e il software di gestione del sistema. Se la scheda madre di un computer fisico include una BMC, quando il computer è collegato (se è attivato o attivato e se è installato 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 .

Type:OutOfBandManagementType
Accepted values:None, IPMI, SMASH, Custom
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-BMCRunAsAccount

Specifica l'account RunAs da usare con il dispositivo BMC (BaseBoard Management Controller).

Type:RunAsAccount
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ComputerName

Specifica il nome di un computer identificabile in modo univoco da VMM nella rete. I valori validi per questo parametro sono:

  • Nome di dominio completo
  • Indirizzo IPv4 o IPv6
  • Nome NetBIOS
Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Description

Specifica una descrizione per l'host VMM.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPAddress

Specifica un indirizzo IPv4 o IPv6.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

Specifica che lo stato del processo viene monitorato e archiviato nella variabile indicata in questo parametro.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LogicalNetwork

Specifica una rete logica. Una rete logica è un raggruppamento denominato di subnet IP e VLAN usati per organizzare e semplificare le assegnazioni di rete.

Type:LogicalNetwork
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ManagementAdapterMACAddress

Specifica l'indirizzo MAC della scheda di rete fisica nel computer che deve essere usato dal server VMM per comunicare con questo host.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Specifica l'ID del suggerimento prestazioni e ottimizzazione risorse (suggerimento PRO) che ha attivato questa azione. Questo parametro consente di controllare i suggerimenti PRO.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

Indica che il processo viene eseguito in modo asincrono in modo che il controllo restituisca immediatamente alla shell dei comandi.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SMBiosGuid

Specifica l'identificatore univoco globale del BIOS di Gestione sistema (GUID SMBIOS) per un computer fisico associato a un record per tale computer fisico in VMM.

SMBIOS definisce strutture di dati e metodi di accesso che consentono a un utente o all'applicazione di archiviare e recuperare informazioni sull'hardware in questo computer, ad esempio il nome del sistema, del produttore o della versione del BIOS di sistema. Windows ottiene i dati SMBIOS all'avvio del sistema e rende i dati disponibili per i programmi.

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Subnet

Specifica una subnet IP (IPv4 o IPv6) Inter-Domain nella notazione routing senza classi (CIDR).

  • 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 gruppi host figlio.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMHostConfig

Specifica un oggetto di configurazione del computer fisico.

Type:PhysicalComputerConfig
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VMHostGroup

Specifica un oggetto gruppo host di macchina virtuale.

Type:HostGroup
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMHostProfile

Specifica un oggetto profilo host della macchina virtuale.

Type:PhysicalComputerProfile
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMMServer

Specifica un oggetto server Virtual Machine Manager.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Output

Host

Questo cmdlet restituisce un oggetto Host .

Note

  • Richiede un oggetto profilo host, che può essere recuperato usando il cmdlet Get-SCVMHostProfile .