New-SCVMHost

Module:

VirtualMachineManager

Hiermee maakt u een VMM-host van een fysieke computer met behulp van de eigenschappen die zijn gedefinieerd in een hostprofiel.

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

Met de cmdlet New-SCVMHost maakt u een VMM-host (Virtual Machine Manager) van een fysieke computer met behulp van de eigenschappen die zijn gedefinieerd in een hostprofiel. De fysieke computer moet een out-of-band controller hebben.

Voordat u een host maakt, moet u ervoor zorgen dat er een PXE-server is toegevoegd aan VMM, is er een hostprofiel gemaakt en zijn alle benodigde stuurprogrammabestanden toegevoegd aan de bibliotheek. Opmerking: de PXE-server die u aan VMM toevoegt, moet zich in hetzelfde subnet bevinden als de fysieke computers die u wilt converteren naar beheerde Hyper-V-hosts.

Typ voor meer informatie over de typen hosts die worden ondersteund door VMM Get-Help Add-SCVMHost -Detailed.

Voorbeelden

Voorbeeld 1: Een host maken op basis van een fysieke computer met behulp van een DHCP-hostprofiel

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"

Met de eerste opdracht wordt het Run As-accountobject met de naam BMCRunAsAcct opgehaald en wordt het object opgeslagen in de $BMCRAA variabele.

Met de tweede opdracht wordt de fysieke computer gedetecteerd met het IP-adres 10.10.0.1 met behulp van het Uitvoeren als-account dat is opgegeven in $BMCRAA. Vervolgens wordt de fysieke computer opgeslagen in de variabele $NewPhysicalComputer.

Met de derde opdracht wordt het hostgroepobject met de naam HostGroup01 opgehaald en wordt het object opgeslagen in de $HostGroup variabele.

Met de vierde opdracht wordt het hostprofielobject met de naam HostProfile01 opgehaald en wordt het object opgeslagen in de $HostProfile variabele. HostProfile01 is geconfigureerd voor het verkrijgen van een IP-adres via de DHCP-service.

Met de laatste opdracht maakt u een host van de fysieke computer die is opgeslagen in $NewPhysicalComputer met behulp van het hostprofiel dat is opgeslagen in $HostProfile en noemt u deze NewHost01.

Voorbeeld 2: Een host maken op basis van een fysieke computer met behulp van een statisch HOSTprofiel op basis van 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"

Met de eerste opdracht wordt het Run As-accountobject met de naam BMCRunAsAccount opgehaald en wordt het object opgeslagen in de $BMCRAA variabele.

De tweede opdracht detecteert de computer met het adres 10.10.0.1, met behulp van het Uitvoeren als-account dat is opgeslagen in $BMCRAA en slaat de computer vervolgens op in de $NewPhysicalComputer variabele.

Met de derde opdracht wordt het hostgroepobject met de naam HostGroup01 opgehaald en wordt het object opgeslagen in de $HostGroup variabele.

Met de vierde opdracht wordt het hostprofielobject met de naam HostProfile02 opgehaald en wordt het object opgeslagen in de $HostProfile variabele. HostProfile02 is geconfigureerd om een statisch IP-adres toe te wijzen.

Met de laatste opdracht maakt u een host van de fysieke computer die is opgeslagen in $NewPhysicalComputer met behulp van het hostprofiel dat is opgeslagen in $HostProfile, geeft deze de naam NewHost02 en configureert u het MAC-adres, IPAddress en subnet.

Voorbeeld 3: Een bestaande host opnieuw implementeren met een nieuw hostprofiel

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"

Met de eerste opdracht wordt het Run As-accountobject met de naam BMCRunAsAccount opgehaald en wordt het object opgeslagen in de $BMCRaa variabele.

De volgende acht opdrachten slaan eigenschappen op van de host die u opnieuw gaat implementeren.

Met de tiende opdracht wordt de oude host uit VMM verwijderd.

Met de elfde opdracht wordt het hostgroepobject met de naam New HostGroup01 opgehaald en wordt het object opgeslagen in de $NewHostGroup variabele.

Met de twaalfde opdracht wordt het hostprofielobject met de naam HostProfile02 opgehaald en wordt het object opgeslagen in de $NewHostProfile variabele.

Met de laatste opdracht wordt de oude host opnieuw geïmplementeerd met behulp van de vorige instellingen waarmee de host wordt geïdentificeerd, maar naar een nieuwe hostrup (opgeslagen in $NewHostGroup) en met bijgewerkte profielinstellingen (opgeslagen in $NewHostProfile).

Parameters

-BMCAddress

Hiermee geeft u het out-of-band BMC-adres (BaseBoard Management Controller) op voor een specifieke fysieke machine. Dit kan een IP-adres, de FQDN (Fully Qualified Domain Name) of het DNS-voorvoegsel zijn (meestal dezelfde naam als de NetBIOS-naam).

Normaal gesproken zijn het BMC-adres en de bijbehorende verbinding met het netwerk gescheiden van het IP-adres dat is gekoppeld aan een standaardnetwerkadapter. Sommige computers gebruiken ook een standaardnetwerkadapter om één adres voor de BMC en voor de netwerkadapter op te geven. Het BMC-adres heeft echter een unieke poort en is dus uniek identificeerbaar op het netwerk.

• Voorbeeld van IPv4-indeling: -BMCAddress "10.0.0.21"
• Voorbeeld van Ipv6-indeling: -BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829"
• Voorbeeld van FQDN-indeling: -BMCAddress "Computer01.Contoso.com"
• Voorbeeld van NetBIOS-indeling: -BMCAddress "Computer01"

Opmerking: VMM gebruikt standaard een IP-adres of FQDN voor het BMCAddress. Het is echter ook mogelijk om een Windows PowerShell module te maken waarmee u andere typen adressen kunt opgeven als het BMC-adres.

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

-BMCCustomConfigurationProvider

Hiermee geeft u een configuratieproviderobject op voor een BMC (Baseboard Management Controller). Een configuratieprovider is een invoegtoepassing voor VMM die VMM PowerShell-opdrachten vertaalt naar API-aanroepen die specifiek zijn voor een type baseboard-beheercontroller. U moet deze parameter gebruiken met het aangepaste BMCProtocol.

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

-BMCPort

Hiermee geeft u de out-of-band BMC-poort (BaseBoard Management Controller) op voor een specifieke fysieke machine. Een BMC-poort wordt ook wel een serviceprocessorpoort genoemd. Voorbeeld van standaardpoorten zijn 623 voor IPMI en 443 voor SMASH via WS-Man.

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

-BMCProtocol

Hiermee geeft u het protocol op dat VMM gebruikt om te communiceren met de out-of-band baseboard management controller (BMC). Geldige waarden zijn: IPMI, SMASH, Custom.

Een BMC (ook wel bekend als een serviceprocessor of beheercontroller) is een gespecialiseerde controller op het moederbord van een server die een interface tussen de hardware- en systeembeheersoftware fungeert. Als het moederbord van een fysieke machine een BMC bevat, wanneer de machine is aangesloten (of deze is uitgeschakeld of ingeschakeld en of een besturingssysteem is geïnstalleerd), is informatie over systeemhardware en de status van die systeemhardware beschikbaar.

Voorbeeldindeling: -BMCProtocol "Custom"

Opmerking: Voor het aangepaste protocol moet u de parameter BMCCustomConfigurationProvider gebruiken.

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

-BMCRunAsAccount

Hiermee geeft u het Uitvoeren als-account op dat moet worden gebruikt met het BMC-apparaat (Baseboard Management Controller).

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

-BypassADMachineAccountCheck

Geeft aan dat deze cmdlet een computeraccount hergebruikt dat al bestaat in Active Directory. New-SCVMHost controleert Standaard Active Directory voor een bestaand account met de opgegeven naam om te voorkomen dat computeraccounts worden overschreven.

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

-ComputerName

Hiermee geeft u de naam op van een computer die door VMM uniek kan worden geïdentificeerd in uw netwerk. De aanvaardbare waarden voor deze parameter zijn:

• FQDN
• IPv4- of IPv6-adres
• NetBIOS-naam

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

-Description

Hiermee geeft u een beschrijving voor de VMM-host.

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

-IPAddress

Hiermee geeft u een IPv4- of IPv6-adres op.

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

-JobVariable

Hiermee geeft u op dat de voortgang van de taak wordt bijgehouden en opgeslagen in de variabele met de naam van deze parameter.

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

-LogicalNetwork

Hiermee geeft u een logisch netwerk op. Een logisch netwerk is een benoemde groepering van IP-subnetten en VLAN's die worden gebruikt om netwerktoewijzingen te organiseren en te vereenvoudigen.

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

-ManagementAdapterMACAddress

Hiermee geeft u het MAC-adres van de fysieke netwerkadapter op de computer die moet worden gebruikt door de VMM-server om te communiceren met deze host.

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

-PROTipID

Hiermee geeft u de id op van de tip Prestatie- en resourceoptimalisatie (PRO-tip) die deze actie heeft geactiveerd. Met deze parameter kunt u PRO-tips controleren.

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

-RunAsynchronously

Geeft aan dat de taak asynchroon wordt uitgevoerd, zodat het besturingselement onmiddellijk terugkeert naar de opdrachtshell.

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

-SMBiosGuid

Hiermee geeft u de SYSTEM Management BIOS globally unique identifier (SMBIOS GUID) voor een fysieke computer die is gekoppeld aan een record voor die fysieke computer in VMM.

SMBIOS definieert gegevensstructuren en toegangsmethoden waarmee een gebruiker of toepassing informatie over hardware op deze computer kan opslaan en ophalen, zoals de naam van het systeem, de fabrikant of de BIOS-versie van het systeem. Windows haalt SMBIOS-gegevens op bij het opstarten van het systeem en maakt die gegevens beschikbaar voor programma's.

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

-Subnet

Hiermee geeft u een IP-subnet (IPv4 of IPv6) op in de CIDR-notatie (Classless Inter-Domain Routing).

• Voorbeeldindeling voor een IPv4-subnet: 192.168.0.1/24
• Voorbeeldindeling voor een IPv6-subnet: FD4A:29CD:184F:3A2C::/64

Opmerking: een IP-subnet kan niet overlappen met een ander subnet in een hostgroep of onderliggende hostgroepen.

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

-VMHostConfig

Hiermee geeft u een configuratieobject voor fysieke computers.

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

-VMHostGroup

Hiermee geeft u een hostgroepobject voor virtuele machines op.

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

-VMHostProfile

Hiermee geeft u een hostprofielobject voor virtuele machines op.

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

-VMMServer

Hiermee geeft u een VMM-serverobject op.

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

Uitvoerwaarden

Host

Met deze cmdlet wordt een hostobject geretourneerd.

Notities

• Hiervoor is een hostprofielobject vereist dat kan worden opgehaald met behulp van de cmdlet Get-SCVMHostProfile .

Verwante koppelingen

• Add-SCVMHost
• Disable-SCVMHost
• Enable-SCVMHost
• Find-SCComputer
• Get-SCRunAsAccount
• Get-SCVMHost
• Get-SCVMHostGroup
• Get-SCVMHostNetworkAdapter
• Move-SCVMHost
• Read-SCVMHost
• Register-SCVMHost
• Remove-SCVMHost
• Repair-SCVMHost
• Restart-SCVMHost
• Set-SCVMHost
• Start-SCVMHost
• Stop-SCVMHost