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 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 do nowego hosta (przechowywanego 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 w celu zapewnienia jednego adresu 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 Windows PowerShell, który umożliwia określenie innych typów adresów jako adresu kontrolera 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 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 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 kontrolera BMC jest również nazywany portem procesora usług. Przykładowe domyślne porty to 623 dla protokołu IPMI i 443 dla powłoki SMASH przez program 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ą 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 (czy jest wyłączona, czy włączona, i czy jest zainstalowany system operacyjny), 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 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, które są używane do organizowania i upraszczania przypisań sieci.
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 komunikacji 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, który jest skojarzony 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 systemowa wersja systemu BIOS. 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 classless 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ć za pomocą polecenia cmdlet Get-SCVMHostProfile .