New-SCVMHost
Vytvoří hostitele VMM z fyzického počítače pomocí vlastností definovaných v profilu hostitele.
Syntaxe
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
Rutina New-SCVMHost vytvoří hostitele nástroje Virtual Machine Manager (VMM) z fyzického počítače pomocí vlastností definovaných v profilu hostitele. Fyzický počítač musí mít řadič mimo pásmo.
Před vytvořením hostitele se ujistěte, že byl server PXE přidán do nástroje VMM, byl vytvořen profil hostitele a všechny potřebné soubory ovladačů byly přidány do knihovny. Poznámka: Server PXE, který přidáte do nástroje VMM, musí být ve stejné podsíti jako fyzické počítače, které chcete převést na spravované hostitele Hyper-V.
Další informace o typech hostitelů podporovaných nástrojem VMM potřebujete typ Get-Help Add-SCVMHost -Detailed.
Příklady
Příklad 1: Vytvoření hostitele z fyzického počítače pomocí profilu hostitele založeného na protokolu 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"První příkaz získá objekt účtu Spustit jako s názvem BMCRunAsAcct a uloží objekt do $BMCRAA proměnné.
Druhý příkaz zjistí fyzický počítač s IP adresou 10.10.0.1 pomocí účtu Spustit jako zadaného v $BMCRAA. Pak uloží fyzický počítač do proměnné $NewPhysicalComputer.
Třetí příkaz získá objekt skupiny hostitelů s názvem HostGroup01 a uloží objekt do proměnné $HostGroup.
Čtvrtý příkaz získá objekt profilu hostitele s názvem HostProfile01 a uloží objekt do $HostProfile proměnné. HostProfile01 je nakonfigurovaný tak, aby získal IP adresu prostřednictvím služby DHCP.
Poslední příkaz vytvoří hostitele z fyzického počítače uloženého v $NewPhysicalComputer pomocí profilu hostitele uloženého v $HostProfile a pojmenuje ho NewHost01.
Příklad 2: Vytvoření hostitele z fyzického počítače pomocí profilu hostitele založeného na statické IP adrese
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"První příkaz získá objekt účtu Spustit jako s názvem BMCRunAsAccount a uloží objekt do $BMCRAA proměnné.
Druhý příkaz zjistí počítač s adresou 10.10.0.1 pomocí účtu Spustit jako uloženého v $BMCRAA a pak uloží počítač do proměnné $NewPhysicalComputer.
Třetí příkaz získá objekt skupiny hostitelů s názvem HostGroup01 a uloží objekt do proměnné $HostGroup.
Čtvrtý příkaz získá objekt profilu hostitele s názvem HostProfile02 a uloží objekt do $HostProfile proměnné. HostProfile02 je nakonfigurovaný tak, aby přiděloval statickou IP adresu.
Poslední příkaz vytvoří hostitele z fyzického počítače uloženého v $NewPhysicalComputer pomocí profilu hostitele uloženého v $HostProfile, dá mu název NewHost02 a nakonfiguruje adresu MAC, IPAddress a podsíť.
Příklad 3: Opětovné nasazení existujícího hostitele s novým profilem hostitele
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"První příkaz získá objekt účtu Spustit jako s názvem BMCRunAsAccount a uloží objekt do $BMCRaa proměnné.
Následujících osm příkazů uloží vlastnosti z hostitele, kterého budete znovu nasadit.
Desátý příkaz odebere starého hostitele z nástroje VMM.
Jedenáctý příkaz získá objekt skupiny hostitelů s názvem New HostGroup01 a uloží objekt do $NewHostGroup proměnné.
Dvanáctý příkaz získá objekt profilu hostitele s názvem HostProfile02 a uloží objekt do $NewHostProfile proměnné.
Poslední příkaz znovu nasadí starého hostitele pomocí předchozích nastavení, která identifikují hostitele, ale na nový hostitel gorup (uložený v $NewHostGroup) a s aktualizovaným nastavením profilu (uloženým v $NewHostProfile).
Parametry
-BMCAddress
Určuje nebo aktualizuje adresu řadiče pro správu základní desky (BMC) mimo pásmo pro konkrétní fyzický počítač. Může se jednat o IP adresu, plně kvalifikovaný název domény (FQDN) nebo předponu DNS (což je obvykle stejný název jako název NetBIOS).
Adresa řadiče pro správu základní desky a její připojení k síti jsou obvykle oddělené od IP adresy přidružené ke standardnímu síťovému adaptéru. Některé počítače také používají standardní síťový adaptér k poskytnutí jedné adresy řadiče pro správu základní desky a síťového adaptéru. Adresa řadiče pro správu základní desky má ale jedinečný port, který je tak jednoznačně identifikovatelný v síti.
- Příklad formátu IPv4:
-BMCAddress "10.0.0.21" - Příklad formátu Ipv6:
-BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829" - Příklad formátu plně kvalifikovaného názvu domény:
-BMCAddress "Computer01.Contoso.com" - Příklad formátu NetBIOS:
-BMCAddress "Computer01"
Poznámka: Ve výchozím nastavení používá nástroj VMM PRO řadiče pro správu základní desky IP adresu nebo plně kvalifikovaný název domény. Jako adresu řadiče pro správu základní desky je ale také možné vytvořit modul Windows PowerShellu, který umožňuje zadat jiné typy adres.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-BMCCustomConfigurationProvider
Určuje nebo aktualizuje objekt zprostředkovatele konfigurace pro řadič pro správu základní desky (BMC). Zprostředkovatel konfigurace je modul plug-in do nástroje VMM, který překládá příkazy PowerShellu VMM na volání rozhraní API, která jsou specifická pro typ kontroleru pro správu základní desky. Tento parametr byste měli použít s custom BMCProtocol.
| Typ: | ConfigurationProvider |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-BMCPort
Určuje nebo aktualizuje port řadiče pro správu základní desky (BMC) mimo pásmo pro konkrétní fyzický počítač. Port řadiče pro správu základní desky se také označuje jako port procesoru služby. Příkladem výchozích portů je 623 pro IPMI a 443 pro SMASH přes WS-Man.
| Typ: | UInt32 |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-BMCProtocol
Určuje nebo aktualizuje protokol, který nástroj VMM používá ke komunikaci s řadičem pro správu základní desky (BMC). Platné hodnoty jsou: IPMI, SMASH, Custom.
Řadič pro správu základní desky (označovaný také jako procesor služeb nebo řadič pro správu) je specializovaný kontroler na základní desce serveru, který funguje jako rozhraní mezi hardwarem a softwarem pro správu systému. Pokud základní deska fyzického počítače obsahuje řadič pro správu základní desky, je-li počítač připojen (bez ohledu na to, zda je vypnutý nebo zapnutý a zda je nainstalován operační systém), informace o hardwaru systému a stavu tohoto systému je k dispozici.
Příklad formátu: -BMCProtocol "Custom"
Poznámka: Vlastní protokol vyžaduje, abyste použili parametr BMCCustomConfigurationProvider.
| Typ: | OutOfBandManagementType |
| Přípustné hodnoty: | None, IPMI, SMASH, Custom |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-BMCRunAsAccount
Určuje účet Spustit jako, který se má použít se zařízením řadiče pro správu základní desky (BMC).
| Typ: | RunAsAccount |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-BypassADMachineAccountCheck
Označuje, že tato rutina znovu používá účet počítače, který již existuje ve službě Active Directory. Ve výchozím nastavení New-SCVMHost kontroluje, jestli služba Active Directory obsahuje existující účet se zadaným názvem, aby se zabránilo přepsání účtů počítačů.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-ComputerName
Určuje název počítače, který může nástroj VMM jednoznačně identifikovat v síti. Přijatelné hodnoty pro tento parametr jsou:
- FQDN
- Adresa IPv4 nebo IPv6
- Název rozhraní NetBIOS
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Description
Určuje popis hostitele VMM.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-IPAddress
Určuje adresu IPv4 nebo IPv6.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-JobVariable
Určuje, že průběh úlohy je sledován a uložen v proměnné pojmenované tímto parametrem.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-LogicalNetwork
Určuje logickou síť. Logická síť je pojmenované seskupení podsítí IP a sítí VLAN, které slouží k uspořádání a zjednodušení přiřazování sítě.
| Typ: | LogicalNetwork |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-ManagementAdapterMACAddress
Určuje adresu MAC fyzického síťového adaptéru v počítači, který má server VMM používat ke komunikaci s tímto hostitelem.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-PROTipID
Určuje ID tipu pro optimalizaci výkonu a prostředků (TIP PRO), který tuto akci aktivoval. Tento parametr umožňuje auditovat tipy PRO.
| Typ: | Guid |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-RunAsynchronously
Označuje, že úloha běží asynchronně, aby se ovládací prvek okamžitě vrátil do příkazového prostředí.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-SMBiosGuid
Určuje globálně jedinečný identifikátor systému BIOS (SMBIOS GUID) fyzického počítače, který je přidružený k záznamu pro tento fyzický počítač v nástroji VMM.
SMBIOS definuje datové struktury a metody přístupu, které uživateli nebo aplikaci umožňují ukládat a načítat informace o hardwaru v tomto počítači, například název systému, výrobce nebo verze systému BIOS. Systém Windows získává data SMBIOS při spuštění systému a zpřístupňuje tato data programům.
| Typ: | Guid |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Subnet
Určuje podsíť PROTOKOLU IP (IPv4 nebo IPv6) v zápisu CIDR (Classless Inter-Domain Routing).
- Příklad formátu pro podsíť IPv4:
192.168.0.1/24 - Příklad formátu podsítě IPv6:
FD4A:29CD:184F:3A2C::/64
Poznámka: Podsíť PROTOKOLU IP se nesmí překrývat s žádnou jinou podsítí ve skupině hostitelů nebo podřízených skupinách hostitelů.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-VMHostConfig
Určuje objekt konfigurace fyzického počítače.
| Typ: | PhysicalComputerConfig |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-VMHostGroup
Určuje objekt skupiny hostitelů virtuálního počítače.
| Typ: | HostGroup |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-VMHostProfile
Určuje objekt profilu hostitele virtuálního počítače.
| Typ: | PhysicalComputerProfile |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-VMMServer
Určuje objekt serveru VMM.
| Typ: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
Výstupy
Host
Tato rutina vrátí objekt Host.
Poznámky
- Vyžaduje objekt profilu hostitele, který lze načíst pomocí rutiny Get-SCVMHostProfile.