New-SCVMHost
Hiermee maakt u een VMM-host van een fysieke computer met behulp van de eigenschappen die zijn gedefinieerd in een hostprofiel.
Syntaxis
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
De cmdlet New-SCVMHost maakt een VMM-host (Virtual Machine Manager) op basis 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 Get-Help Add-SCVMHost -Detailedvoor meer informatie over de typen hosts die door VMM worden ondersteund.
Voorbeelden
Voorbeeld 1: Een host maken op basis van een fysieke computer met behulp van een op DHCP gebaseerd 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 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 variabele $BMCRaa.
Met de volgende acht opdrachten worden eigenschappen van de host opgeslagen 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 variabele $NewHostGroup.
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 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 |
| Vereist: | True |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | 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 Custom BMCProtocol.
| Type: | ConfigurationProvider |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | 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 |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-BMCProtocol
Hiermee geeft u het protocol op dat door VMM wordt gebruikt om te communiceren met de out-of-band baseboard management controller (BMC). Geldige waarden zijn: IPMI, SMASH, Custom.
Een BMC (ook wel een serviceprocessor of beheercontroller genoemd) is een gespecialiseerde controller op het moederbord van een server die een interface tussen de hardware- en systeembeheersoftware uitvoert. 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), informatie over systeemhardware en de status van die systeemhardware beschikbaar is.
Voorbeeldindeling: -BMCProtocol "Custom"
Opmerking: Voor het aangepaste protocol moet u de parameter BMCCustomConfigurationProvider gebruiken.
| Type: | OutOfBandManagementType |
| Geaccepteerde waarden: | None, IPMI, SMASH, Custom |
| Position: | Named |
| Default value: | None |
| Vereist: | True |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-BMCRunAsAccount
Hiermee geeft u het Uitvoeren als-account dat moet worden gebruikt met het BMC-apparaat (Baseboard Management Controller).
| Type: | RunAsAccount |
| Position: | Named |
| Default value: | None |
| Vereist: | True |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-BypassADMachineAccountCheck
Geeft aan dat deze cmdlet een computeraccount hergebruikt dat al bestaat in Active Directory. Standaard controleert New-SCVMHost Active Directory op een bestaand account met de opgegeven naam om te voorkomen dat computeraccounts worden overschreven.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-ComputerName
Hiermee geeft u de naam op van een computer die VMM uniek kan identificeren in uw netwerk. De acceptabele waarden voor deze parameter zijn:
- FQDN
- IPv4- of IPv6-adres
- NetBIOS-naam
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | True |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-Description
Hiermee geeft u een beschrijving voor de VMM-host.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-IPAddress
Hiermee geeft u een IPv4- of IPv6-adres op.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | 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 |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-LogicalNetwork
Hiermee geeft u een logisch netwerk. 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 |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-ManagementAdapterMACAddress
Hiermee geeft u het MAC-adres van de fysieke netwerkadapter op de computer die door de VMM-server moet worden gebruikt om met deze host te communiceren.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | 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 |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | 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 |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | 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 |
| Vereist: | True |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-Subnet
Hiermee geeft u een IP-subnet (IPv4 of IPv6) in classless Inter-Domain routing (CIDR) notatie.
- Voorbeeldindeling voor een IPv4-subnet:
192.168.0.1/24 - Voorbeeldindeling voor een IPv6-subnet:
FD4A:29CD:184F:3A2C::/64
Opmerking: een IP-subnet mag niet overlappen met een ander subnet in een hostgroep of onderliggende hostgroepen.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-VMHostConfig
Hiermee geeft u een configuratieobject van een fysieke computer.
| Type: | PhysicalComputerConfig |
| Position: | Named |
| Default value: | None |
| Vereist: | True |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-VMHostGroup
Hiermee geeft u een hostgroepobject voor de virtuele machine op.
| Type: | HostGroup |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-VMHostProfile
Hiermee geeft u een hostprofielobject voor de virtuele machine op.
| Type: | PhysicalComputerProfile |
| Position: | Named |
| Default value: | None |
| Vereist: | True |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-VMMServer
Hiermee geeft u een VMM-serverobject.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
Uitvoerwaarden
Host
Deze cmdlet retourneert een Host-object.
Notities
- Hiervoor is een hostprofielobject vereist dat kan worden opgehaald met behulp van de cmdlet Get-SCVMHostProfile.