New-SCVMHost
Tworzy hosta programu VMM z komputera fizycznego przy użyciu właściwości zdefiniowanych w profilu hosta.
Składnia
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>]Opis
Polecenie cmdlet New-SCVMHost tworzy hosta programu Virtual Machine Manager (VMM) z komputera fizycznego przy użyciu właściwości zdefiniowanych w profilu hosta. Komputer fizyczny musi mieć kontroler poza pasmem.
Przed utworzeniem hosta upewnij się, że serwer PXE został dodany do programu VMM, profil hosta został utworzony i wszystkie potrzebne pliki sterowników zostały dodane do biblioteki. Uwaga: serwer PXE dodany do programu VMM musi znajdować się w tej samej podsieci co komputery fizyczne, które mają zostać przekonwertowane na zarządzane hosty funkcji Hyper-V.
Aby uzyskać więcej informacji na temat typów hostów obsługiwanych przez program VMM, wpisz Get-Help Add-SCVMHost -Detailed.
Przykłady
Przykład 1. Tworzenie hosta z komputera fizycznego przy użyciu profilu hosta opartego na protokole 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"Pierwsze polecenie pobiera obiekt konta Uruchom jako o nazwie BMCRunAsAcct i przechowuje obiekt w zmiennej $BMCRAA.
Drugie polecenie odnajduje komputer fizyczny z adresem IP 10.10.0.1 przy użyciu konta Uruchom jako podanego w $BMCRAA. Następnie przechowuje komputer fizyczny w zmiennej $NewPhysicalComputer.
Trzecie polecenie pobiera obiekt grupy hostów o nazwie HostGroup01 i przechowuje obiekt w zmiennej $HostGroup.
Czwarte polecenie pobiera obiekt profilu hosta o nazwie HostProfile01 i przechowuje obiekt w zmiennej $HostProfile. HostProfile01 jest skonfigurowany do uzyskiwania adresu IP za pośrednictwem usługi DHCP.
Ostatnie polecenie tworzy hosta z komputera fizycznego przechowywanego w $NewPhysicalComputer przy użyciu profilu hosta przechowywanego w $HostProfile i nada mu nazwę NewHost01.
Przykład 2. Tworzenie hosta z komputera fizycznego przy użyciu statycznego profilu hosta opartego na protokole 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"Pierwsze polecenie pobiera obiekt konta Uruchom jako o nazwie BMCRunAsAccount i przechowuje obiekt w zmiennej $BMCRAA.
Drugie polecenie odnajduje komputer z adresem 10.10.0.1 przy użyciu konta Uruchom jako przechowywanego w $BMCRAA, a następnie przechowuje komputer w zmiennej $NewPhysicalComputer.
Trzecie polecenie pobiera obiekt grupy hostów o nazwie HostGroup01 i przechowuje obiekt w zmiennej $HostGroup.
Czwarte polecenie pobiera obiekt profilu hosta o nazwie HostProfile02 i przechowuje obiekt w zmiennej $HostProfile. HostProfile02 jest skonfigurowany do przydzielenia statycznego adresu IP.
Ostatnie polecenie tworzy hosta z komputera fizycznego przechowywanego w $NewPhysicalComputer przy użyciu profilu hosta przechowywanego w $HostProfile, nadaje mu nazwę NewHost02 i konfiguruje adres MAC, adres IPAddress i podsieć.
Przykład 3. Ponowne wdrażanie istniejącego hosta przy użyciu nowego profilu hosta
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"Pierwsze polecenie pobiera obiekt konta Uruchom jako o nazwie BMCRunAsAccount i przechowuje obiekt w zmiennej $BMCRaa.
Następne osiem poleceń zapisuje właściwości z hosta, który zamierzasz ponownie wdrożyć.
Dziesiąte polecenie usuwa stary host z programu VMM.
Jedenaście polecenie pobiera obiekt grupy hostów o nazwie New HostGroup01 i przechowuje obiekt w zmiennej $NewHostGroup.
Dwunaste polecenie pobiera obiekt profilu hosta o nazwie HostProfile02 i przechowuje obiekt w zmiennej $NewHostProfile.
Ostatnie polecenie ponownie wdraża stary host przy użyciu poprzednich ustawień identyfikujących hosta, ale do nowego hosta (przechowywanego w $NewHostGroup) i ze zaktualizowanymi ustawieniami profilu (przechowywanymi w $NewHostProfile).
Parametry
-BMCAddress
Określa lub aktualizuje adres kontrolera zarządzania płytą główną poza pasmem (BMC) dla określonej maszyny fizycznej. Może to być adres IP, w pełni kwalifikowana nazwa domeny (FQDN) lub prefiks DNS (który jest zwykle taką samą nazwą jak nazwa NetBIOS).
Zazwyczaj adres BMC i jego połączenie z siecią są oddzielone od adresu IP skojarzonego ze standardową kartą sieciową. Alternatywnie niektóre komputery używają standardowej karty sieciowej, aby podać pojedynczy adres kontrolera BMC i dla karty sieciowej. Jednak adres BMC ma unikatowy port i jest w ten sposób jednoznacznie rozpoznawalny w sieci.
- Przykładowy format IPv4:
-BMCAddress "10.0.0.21" - Przykładowy format Ipv6:
-BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829" - Przykładowy format nazwy FQDN:
-BMCAddress "Computer01.Contoso.com" - Przykładowy format NetBIOS:
-BMCAddress "Computer01"
Uwaga: domyślnie program VMM używa adresu IP lub nazwy FQDN dla adresu BMCAddress. Istnieje jednak również możliwość utworzenia modułu Windows PowerShell, który umożliwia określenie innych typów adresów jako adresu BMC.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BMCCustomConfigurationProvider
Określa lub aktualizuje obiekt dostawcy konfiguracji dla kontrolera zarządzania płytą główną (BMC). Dostawca konfiguracji to wtyczka programu VMM, która tłumaczy polecenia programu PowerShell programu VMM na wywołania interfejsu API specyficzne dla typu kontrolera zarządzania płytą główną. Należy użyć tego parametru z niestandardową kolumną BMCProtocol.
| Type: | ConfigurationProvider |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BMCPort
Określa lub aktualizuje port kontrolera zarządzania płytą główną poza pasmem (BMC) dla określonej maszyny fizycznej. Port BMC jest również nazywany portem procesora usług. Przykładowe porty domyślne to 623 dla protokołu IPMI i 443 dla programu SMASH za pośrednictwem programu WS-Man.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BMCProtocol
Określa lub aktualizuje protokół używany przez program VMM do komunikowania się z kontrolerem zarządzania płytą bazową poza pasmem (BMC). Prawidłowe wartości to: IPMI, SMASH, Custom.
Kontroler BMC (znany również jako procesor usługi lub kontroler zarządzania) jest wyspecjalizowanym kontrolerem na płycie głównej serwera, który pełni funkcję interfejsu między oprogramowaniem do zarządzania sprzętem i systemem. Jeśli płyta główna maszyny fizycznej zawiera kontroler BMC, gdy maszyna jest podłączona (czy jest wyłączona, czy włączona, oraz czy system operacyjny jest zainstalowany), informacje o sprzęcie systemowym i stanie kondycji sprzętu systemu są dostępne.
Przykładowy format: -BMCProtocol "Custom"
Uwaga: Protokół niestandardowy wymaga użycia parametru 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
Określa konto Uruchom jako do użycia z urządzeniem kontrolera zarządzania płytą główną (BMC).
| Type: | RunAsAccount |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BypassADMachineAccountCheck
Wskazuje, że to polecenie cmdlet ponownie używa konta komputera, które już istnieje w usłudze Active Directory. Domyślnie polecenie New-SCVMHost sprawdza usługę Active Directory dla istniejącego konta o określonej nazwie, aby zapobiec zastępowaniu kont komputerów.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ComputerName
Określa nazwę komputera, który program VMM może jednoznacznie zidentyfikować w sieci. Dopuszczalne wartości dla tego parametru to:
- Nazwa FQDN
- Adres IPv4 lub IPv6
- Nazwa NetBIOS
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Określa opis hosta programu VMM.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IPAddress
Określa adres IPv4 lub IPv6.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Określa, że postęp zadania jest śledzony i przechowywany w zmiennej o nazwie przez ten parametr.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LogicalNetwork
Określa sieć logiczną. Sieć logiczna to nazwane grupowanie podsieci IP i sieci VLAN używane do organizowania i upraszczania przypisań sieciowych.
| Type: | LogicalNetwork |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ManagementAdapterMACAddress
Określa adres MAC fizycznej karty sieciowej na komputerze, który ma być używany przez serwer programu VMM do komunikowania się z tym hostem.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Określa identyfikator porady wydajności i optymalizacji zasobów (porada PRO), która wyzwoliła tę akcję. Ten parametr umożliwia inspekcję porad PRO.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Wskazuje, że zadanie jest uruchamiane asynchronicznie, aby kontrolka natychmiast wracała do powłoki poleceń.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SMBiosGuid
Określa system BIOS globalnie unikatowy identyfikator (SMBIOS GUID) dla komputera fizycznego skojarzonego z rekordem dla tego komputera fizycznego w programie VMM.
SMBIOS definiuje struktury danych i metody dostępu, które umożliwiają użytkownikowi lub aplikacji przechowywanie i pobieranie informacji o sprzęcie na tym komputerze, takich jak nazwa systemu, producenta lub wersji systemu BIOS systemu. System Windows pobiera dane SMBIOS podczas uruchamiania systemu i udostępnia te dane programom.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Subnet
Określa podsieć IP (IPv4 lub IPv6) w notacji Bezklasowe Inter-Domain Routing (CIDR).
- Przykładowy format podsieci IPv4:
192.168.0.1/24 - Przykładowy format podsieci IPv6:
FD4A:29CD:184F:3A2C::/64
Uwaga: podsieć IP nie może nakładać się na żadną inną podsieć w grupie hostów lub podrzędnych grupach hostów.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMHostConfig
Określa obiekt konfiguracji komputera fizycznego.
| Type: | PhysicalComputerConfig |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMHostGroup
Określa obiekt grupy hostów maszyny wirtualnej.
| Type: | HostGroup |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMHostProfile
Określa obiekt profilu hosta maszyny wirtualnej.
| Type: | PhysicalComputerProfile |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMMServer
Określa obiekt serwera programu VMM.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Dane wyjściowe
Host
To polecenie cmdlet zwraca obiekt hosta .
Uwagi
- Wymaga obiektu profilu hosta, który można pobrać przy użyciu polecenia cmdlet Get-SCVMHostProfile .