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 alla nödvändiga drivrutinsfiler har lagts till i biblioteket. Obs! Den PXE-server 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 kör som-kontot 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 senaste 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 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 senaste kommandot distribuerar om den gamla värden med hjälp av de tidigare inställningarna som identifierar värden, men till en ny värd-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 IP-adressen 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" - Exempel på FQDN-format:
-BMCAddress "Computer01.Contoso.com" - Exempel på NetBIOS-format:
-BMCAddress "Computer01"
Obs! Som standard använder VMM en IP-adress eller ett fullständigt domännamn för BMCAddress. Det går dock också att skapa en Windows PowerShell-modul som gör att du kan ange andra typer av adresser som BMC-adress.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-BMCCustomConfigurationProvider
Anger, eller uppdaterar, ett konfigurationsproviderobjekt för en baskortshanteringskontrollant (BMC). 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 baseboard-hanteringsstyrenhet. Du bör använda den här parametern med anpassad BMCProtocol.
| Typ: | ConfigurationProvider |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | 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 over WS-Man.
| Typ: | UInt32 |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | 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 känd som en tjänstprocessor eller hanteringsstyrenhet) är en specialiserad styrenhet på moderkortet på en server som agerar ett gränssnitt mellan maskin- och systemhanteringsprogramvaran. 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 tillgänglig.
Exempelformat: -BMCProtocol "Custom"
Obs! Det anpassade protokollet kräver att du använder parametern BMCCustomConfigurationProvider.
| Typ: | OutOfBandManagementType |
| Godkända värden: | None, IPMI, SMASH, Custom |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-BMCRunAsAccount
Anger det Kör som-konto som ska användas med BMC-enheten (Baseboard Management Controller).
| Typ: | RunAsAccount |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-BypassADMachineAccountCheck
Anger att den här cmdleten å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.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-ComputerName
Anger namnet på en dator som VMM unikt kan identifiera i nätverket. De godtagbara värdena för den här parametern är:
- FQDN
- IPv4- eller IPv6-adress
- NetBIOS-namn
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Description
Anger en beskrivning för VMM-värden.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-IPAddress
Anger en IPv4- eller IPv6-adress.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-JobVariable
Anger att jobbstatus spåras och lagras i variabeln med namnet av den här parametern.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | 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.
| Typ: | LogicalNetwork |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | 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.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-PROTipID
Anger ID för tipset prestanda- och resursoptimering (PRO-tips) som utlöste den här åtgärden. Med den här parametern kan du granska PRO-tips.
| Typ: | Guid |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-RunAsynchronously
Anger att jobbet körs asynkront så att kontrollen omedelbart återgår till kommandogränssnittet.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | 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.
| Typ: | Guid |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | 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 kan inte överlappa något annat undernät i en värdgrupp eller underordnade värdgrupper.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-VMHostConfig
Anger ett konfigurationsobjekt för fysiska datorer.
| Typ: | PhysicalComputerConfig |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-VMHostGroup
Anger ett värdgruppsobjekt för en virtuell dator.
| Typ: | HostGroup |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-VMHostProfile
Anger ett värdprofilobjekt för en virtuell dator.
| Typ: | PhysicalComputerProfile |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-VMMServer
Anger ett VMM-serverobjekt.
| Typ: | ServerConnection |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
Utdata
Host
Den här cmdleten returnerar ett Host-objekt.
Kommentarer
- Kräver ett värdprofilobjekt som kan hämtas med hjälp av cmdleten Get-SCVMHostProfile.