Dela via


New-SCVMHost

Skapar en VMM-värd från en fysisk dator med hjälp av egenskaperna som definierats i en värdprofil.

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

Cmdleten New-SCVMHost skapar en VMM-värd (Virtual Machine Manager) från en fysisk dator med hjälp av egenskaperna som definierats i en värdprofil. Den fysiska datorn måste ha en out-of-band-styrenhet.

Innan du skapar en värd kontrollerar du att en PXE-server har lagts till i VMM, att en värdprofil har skapats och att nödvändiga drivrutinsfiler har lagts till i biblioteket. Obs! PXE-servern som du lägger till i VMM måste finnas i samma undernät som de fysiska datorer som du vill konvertera till hanterade Hyper-V-värdar.

Om du vill ha mer information om vilka typer av värdar som stöds av VMM skriver du Get-Help Add-SCVMHost -Detailed.

Exempel

Exempel 1: Skapa en värd från en fysisk dator med hjälp av en DHCP-baserad värdprofil

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"

Det första kommandot hämtar Kör som-kontoobjektet med namnet BMCRunAsAcct och lagrar objektet i variabeln $BMCRAA.

Det andra kommandot identifierar den fysiska datorn med IP-adressen 10.10.0.1 med det Kör som-konto som anges i $BMCRAA. Den lagrar sedan den fysiska datorn i variabeln $NewPhysicalComputer.

Det tredje kommandot hämtar värdgruppsobjektet med namnet HostGroup01 och lagrar objektet i variabeln $HostGroup.

Det fjärde kommandot hämtar värdprofilobjektet med namnet HostProfile01 och lagrar objektet i variabeln $HostProfile. HostProfile01 har konfigurerats för att hämta en IP-adress via DHCP-tjänsten.

Det sista kommandot skapar en värd från den fysiska datorn som lagras i $NewPhysicalComputer med hjälp av värdprofilen som lagras i $HostProfile och ger den namnet NewHost01.

Exempel 2: Skapa en värd från en fysisk dator med hjälp av en statisk IP-baserad värdprofil

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"

Det första kommandot hämtar Kör som-kontoobjektet med namnet BMCRunAsAccount och lagrar objektet i variabeln $BMCRAA.

Det andra kommandot identifierar datorn med adressen 10.10.0.1 med hjälp av Kör som-kontot som lagras i $BMCRAA och lagrar sedan datorn i variabeln $NewPhysicalComputer.

Det tredje kommandot hämtar värdgruppsobjektet med namnet HostGroup01 och lagrar objektet i variabeln $HostGroup.

Det fjärde kommandot hämtar värdprofilobjektet med namnet HostProfile02 och lagrar objektet i variabeln $HostProfile. HostProfile02 har konfigurerats för att allokera en statisk IP-adress.

Det sista kommandot skapar en värd från den fysiska datorn som lagras i $NewPhysicalComputer med hjälp av värdprofilen som lagras i $HostProfile, ger den namnet NewHost02 och konfigurerar MAC-adressen, IPAddress och undernätet.

Exempel 3: Distribuera om en befintlig värd med en ny värdprofil

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"

Det första kommandot hämtar Kör som-kontoobjektet med namnet BMCRunAsAccount och lagrar objektet i variabeln $BMCRaa.

De följande åtta kommandona sparar egenskaper från värden som du ska distribuera om.

Det tionde kommandot tar bort den gamla värden från VMM.

Det elfte kommandot hämtar värdgruppsobjektet med namnet New HostGroup01 och lagrar objektet i variabeln $NewHostGroup.

Det tolfte kommandot hämtar värdprofilobjektet med namnet HostProfile02 och lagrar objektet i variabeln $NewHostProfile.

Det sista kommandot distribuerar om den gamla värden med hjälp av de tidigare inställningarna som identifierar värden, men till en ny värds gorup (lagras i $NewHostGroup) och med uppdaterade profilinställningar (lagras i $NewHostProfile).

Parametrar

-BMCAddress

Anger, eller uppdaterar, BMC-adressen (Out-of-Band Baseboard Management Controller) för en specifik fysisk dator. Detta kan vara en IP-adress, det fullständigt kvalificerade domännamnet (FQDN) eller DNS-prefixet (som vanligtvis är samma namn som NetBIOS-namnet).

Vanligtvis är BMC-adressen och dess anslutning till nätverket åtskilda från DEN IP-adress som är associerad med ett standardnätverkskort. Alternativt kan vissa datorer använda ett standardnätverkskort för att ange en enda adress för BMC och för nätverkskortet. BMC-adressen har dock en unik port och är därmed unikt identifierbar i nätverket.

  • Exempel på IPv4-format: -BMCAddress "10.0.0.21"
  • Exempel på Ipv6-format: -BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829"
  • FQDN-exempelformat: -BMCAddress "Computer01.Contoso.com"
  • Exempel på NetBIOS-format: -BMCAddress "Computer01"

Obs! Som standard använder VMM en IP-adress eller FQDN för BMCAddress. Men det är också möjligt att skapa en Windows PowerShell modul som gör att du kan ange andra typer av adresser som BMC-adressen.

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

-BMCCustomConfigurationProvider

Anger, eller uppdaterar, ett konfigurationsproviderobjekt för en BMC (Baseboard Management Controller). En konfigurationsprovider är ett plugin-program till VMM som översätter VMM PowerShell-kommandon till API-anrop som är specifika för en typ av hanteringsstyrenhet för basbord. Du bör använda den här parametern med custom BMCProtocol.

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

-BMCPort

Anger, eller uppdaterar, BMC-porten (Out-of-Band Baseboard Management Controller) för en specifik fysisk dator. En BMC-port kallas även för en tjänstprocessorport. Exempel på standardportar är 623 för IPMI och 443 för SMASH över WS-Man.

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

-BMCProtocol

Anger, eller uppdaterar, det protokoll som VMM använder för att kommunicera med BMC (Out-of-Band Baseboard Management Controller). Giltiga värden är: IPMI, SMASH, Custom.

En BMC (även kallad tjänstprocessor eller hanteringsstyrenhet) är en specialiserad styrenhet på moderkortet på en server som fungerar som ett gränssnitt mellan programvaran för maskin- och systemhantering. Om moderkortet för en fysisk dator innehåller en BMC, när datorn är ansluten (oavsett om den är avstängd eller påslagen, och om ett operativsystem är installerat eller inte), finns information om systemmaskinvara och tillståndet för systemets maskinvaruhälsa.

Exempelformat: -BMCProtocol "Custom"

Obs! Det anpassade protokollet kräver att du använder parametern 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

Anger det Kör som-konto som ska användas med BMC-enheten (Baseboard Management Controller).

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

-BypassADMachineAccountCheck

Anger att denna cmdlet återanvänder ett datorkonto som redan finns i Active Directory. Som standard kontrollerar New-SCVMHost Active Directory efter ett befintligt konto med det angivna namnet för att förhindra att datorkonton skrivs över.

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

-ComputerName

Anger namnet på en dator som VMM kan identifiera unikt i nätverket. De acceptabla värdena för den här parametern är:

  • FQDN
  • IPv4- eller IPv6-adress
  • NetBIOS-namn
Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Description

Anger en beskrivning av VMM-värden.

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

-IPAddress

Anger en IPv4- eller IPv6-adress.

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

-JobVariable

Anger att jobb förloppet spåras och lagras i variabeln med namnet av den här parametern.

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

-LogicalNetwork

Anger ett logiskt nätverk. Ett logiskt nätverk är en namngiven gruppering av IP-undernät och VLAN som används för att organisera och förenkla nätverkstilldelningar.

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

-ManagementAdapterMACAddress

Anger MAC-adressen för det fysiska nätverkskortet på den dator som ska användas av VMM-servern för att kommunicera med den här värden.

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

-PROTipID

Anger ID för tipset om prestanda- och resursoptimering (PRO-tips) som utlöste den här åtgärden. Med den här parametern kan du granska PRO-tips.

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

-RunAsynchronously

Anger att jobbet körs asynkront så att kontrollen återgår till kommandogränssnittet omedelbart.

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

-SMBiosGuid

Anger systemhanterings-BIOS globalt unik identifierare (SMBIOS GUID) för en fysisk dator som är associerad med en post för den fysiska datorn i VMM.

SMBIOS definierar datastrukturer och åtkomstmetoder som gör att en användare eller ett program kan lagra och hämta information om maskinvara på den här datorn, till exempel namnet på systemet, tillverkaren eller systemets BIOS-version. Windows hämtar SMBIOS-data vid systemstart och gör dessa data tillgängliga för program.

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

-Subnet

Anger ett IP-undernät (IPv4 eller IPv6) i CIDR-notation (Classless Inter-Domain Routing).

  • Exempelformat för ett IPv4-undernät: 192.168.0.1/24
  • Exempelformat för ett IPv6-undernät: FD4A:29CD:184F:3A2C::/64

Obs! Ett IP-undernät får inte överlappa något annat undernät i en värdgrupp eller underordnade värdgrupper.

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

-VMHostConfig

Anger ett konfigurationsobjekt för fysisk dator.

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

-VMHostGroup

Anger ett värdgruppsobjekt för en virtuell dator.

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

-VMHostProfile

Anger ett värdprofilobjekt för en virtuell dator.

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

-VMMServer

Anger ett VMM-serverobjekt.

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

Utdata

Host

Den här cmdleten returnerar ett värdobjekt .

Kommentarer

  • Kräver ett värdprofilobjekt som kan hämtas med cmdleten Get-SCVMHostProfile .