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 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 adresach 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 przydzielania 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 starego hosta z programu VMM.
Jedenaście polecenia 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 starego hosta przy użyciu poprzednich ustawień identyfikujących hosta, ale w nowym hoście (przechowywanym w $NewHostGroup) i przy użyciu zaktualizowanych ustawień profilu (przechowywanych 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ć jeden adres kontrolera BMC i 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 elementu BMCAddress. Istnieje jednak również możliwość utworzenia modułu programu Windows PowerShell, który umożliwia określenie innych typów adresów jako adresu kontrolera BMC.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-BMCCustomConfigurationProvider
Określa lub aktualizuje obiekt dostawcy konfiguracji dla kontrolera zarządzania płytą główną (BMC). Dostawca konfiguracji to wtyczka do 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 kolumną Custom BMCProtocol.
| Typ: | ConfigurationProvider |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-BMCPort
Określa lub aktualizuje port kontrolera zarządzania płytą główną poza pasmem (BMC) dla określonej maszyny fizycznej. Port kontrolera BMC jest również nazywany portem procesora usługi. Przykładowe porty domyślne to 623 dla adresów IPMI i 443 dla powłoki SMASH za pośrednictwem programu WS-Man.
| Typ: | UInt32 |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-BMCProtocol
Określa lub aktualizuje protokół używany przez program VMM do komunikowania się z kontrolerem zarządzania płytą główną 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 działa interfejs 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 (niezależnie od tego, czy jest wyłączona, czy włączona, i czy system operacyjny jest zainstalowany), informacje o sprzęcie systemu i stanie kondycji sprzętu systemu są dostępne.
Przykładowy format: -BMCProtocol "Custom"
Uwaga: Protokół niestandardowy wymaga użycia parametru BMCCustomConfigurationProvider.
| Typ: | OutOfBandManagementType |
| Dopuszczalne wartości: | None, IPMI, SMASH, Custom |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-BMCRunAsAccount
Określa konto Uruchom jako do użycia z urządzeniem kontrolera zarządzania płytą główną (BMC).
| Typ: | RunAsAccount |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-BypassADMachineAccountCheck
Wskazuje, że to polecenie cmdlet ponownie używa konta komputera, które już istnieje w usłudze Active Directory. Domyślnie New-SCVMHost sprawdza usługę Active Directory dla istniejącego konta o określonej nazwie, aby zapobiec zastępowaniu kont komputerów.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-ComputerName
Określa nazwę komputera, który program VMM może jednoznacznie zidentyfikować w sieci. Dopuszczalne wartości tego parametru to:
- FQDN
- Adres IPv4 lub IPv6
- Nazwa NetBIOS
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Description
Określa opis hosta programu VMM.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-IPAddress
Określa adres IPv4 lub IPv6.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-JobVariable
Określa, że postęp zadania jest śledzony i przechowywany w zmiennej o nazwie tego parametru.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-LogicalNetwork
Określa sieć logiczną. Sieć logiczna to nazwane grupowanie podsieci IP i sieci VLAN, które są używane do organizowania i upraszczania przypisań sieci.
| Typ: | LogicalNetwork |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-ManagementAdapterMACAddress
Określa adres MAC fizycznej karty sieciowej na komputerze, który ma być używany przez serwer programu VMM do komunikacji z tym hostem.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | Guid |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-RunAsynchronously
Wskazuje, że zadanie jest uruchamiane asynchronicznie, aby kontrolka natychmiast wracała do powłoki poleceń.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-SMBiosGuid
Określa globalnie unikatowy identyfikator systemu BIOS zarządzania systemem (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, producent lub wersja systemu BIOS systemu. System Windows pobiera dane SMBIOS podczas uruchamiania systemu i udostępnia te dane programom.
| Typ: | Guid |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-VMHostConfig
Określa obiekt konfiguracji komputera fizycznego.
| Typ: | PhysicalComputerConfig |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-VMHostGroup
Określa obiekt grupy hostów maszyny wirtualnej.
| Typ: | HostGroup |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-VMHostProfile
Określa obiekt profilu hosta maszyny wirtualnej.
| Typ: | PhysicalComputerProfile |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-VMMServer
Określa obiekt serwera programu VMM.
| Typ: | ServerConnection |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.