New-SCVMHost
Membuat host VMM dari komputer fisik dengan menggunakan properti yang ditentukan dalam profil host.
Sintaks
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>]Deskripsi
Cmdlet New-SCVMHost membuat host Virtual Machine Manager (VMM) dari komputer fisik dengan menggunakan properti yang ditentukan dalam profil host. Komputer fisik harus memiliki pengontrol out-of-band.
Sebelum Anda membuat host, pastikan bahwa server PXE telah ditambahkan ke VMM, profil host telah dibuat, dan file driver yang diperlukan telah ditambahkan ke pustaka. Catatan: Server PXE yang Anda tambahkan ke VMM harus berada di subnet yang sama dengan komputer fisik yang ingin Anda konversi ke host Hyper-V terkelola.
Untuk informasi selengkapnya tentang jenis host yang didukung oleh VMM, ketik Get-Help Add-SCVMHost -Detailed.
Contoh
Contoh 1: Membuat host dari komputer fisik dengan menggunakan profil host berbasis 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"Perintah pertama mendapatkan objek akun Jalankan Sebagai bernama BMCRunAsAcct dan menyimpan objek dalam variabel $BMCRAA.
Perintah kedua menemukan komputer fisik dengan alamat IP 10.10.0.1 menggunakan akun Jalankan Sebagai yang disediakan dalam $BMCRAA. Kemudian menyimpan komputer fisik dalam variabel $NewPhysicalComputer.
Perintah ketiga mendapatkan objek grup host bernama HostGroup01 dan menyimpan objek dalam variabel $HostGroup.
Perintah keempat mendapatkan objek profil host bernama HostProfile01 dan menyimpan objek dalam variabel $HostProfile. HostProfile01 dikonfigurasi untuk mendapatkan alamat IP melalui layanan DHCP.
Perintah terakhir membuat host dari komputer fisik yang disimpan di $NewPhysicalComputer menggunakan profil host yang disimpan di $HostProfile, dan menamainya NewHost01.
Contoh 2: Membuat host dari komputer fisik dengan menggunakan profil host berbasis IP statis
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"Perintah pertama mendapatkan objek akun Jalankan Sebagai bernama BMCRunAsAccount dan menyimpan objek dalam variabel $BMCRAA.
Perintah kedua menemukan komputer dengan alamat 10.10.0.1, menggunakan akun Jalankan Sebagai yang disimpan di $BMCRAA, lalu menyimpan komputer dalam variabel $NewPhysicalComputer.
Perintah ketiga mendapatkan objek grup host bernama HostGroup01 dan menyimpan objek dalam variabel $HostGroup.
Perintah keempat mendapatkan objek profil host bernama HostProfile02 dan menyimpan objek dalam variabel $HostProfile. HostProfile02 dikonfigurasi untuk mengalokasikan alamat IP statis.
Perintah terakhir membuat host dari komputer fisik yang disimpan di $NewPhysicalComputer menggunakan profil host yang disimpan di $HostProfile, memberinya nama NewHost02, dan mengonfigurasi alamat MAC, IPAddress, dan subnet.
Contoh 3: Menyebarkan ulang host yang ada dengan profil host baru
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"Perintah pertama mendapatkan objek akun Jalankan Sebagai bernama BMCRunAsAccount dan menyimpan objek dalam variabel $BMCRaa.
Delapan perintah berikutnya menyimpan properti dari host yang akan Anda sebarkan ulang.
Perintah kesepuluh menghapus host lama dari VMM.
Perintah ke sebelas mendapatkan objek grup host bernama New HostGroup01 dan menyimpan objek dalam variabel $NewHostGroup.
Perintah ke-12 mendapatkan objek profil host bernama HostProfile02 dan menyimpan objek dalam variabel $NewHostProfile.
Perintah terakhir menyebarkan ulang host lama menggunakan pengaturan sebelumnya yang mengidentifikasi host, tetapi ke gorup host baru (disimpan dalam $NewHostGroup) dan dengan pengaturan profil yang diperbarui (disimpan di $NewHostProfile).
Parameter
-BMCAddress
Menentukan, atau memperbarui, alamat pengontrol manajemen baseboard (BMC) out-of-band untuk komputer fisik tertentu. Ini mungkin alamat IP, nama domain yang sepenuhnya memenuhi syarat (FQDN), atau awalan DNS (yang biasanya nama yang sama dengan nama NetBIOS).
Biasanya, alamat BMC dan koneksinya ke jaringan terpisah dari alamat IP yang terkait dengan adaptor jaringan standar. Atau, beberapa komputer memang menggunakan adaptor jaringan standar untuk menyediakan satu alamat untuk BMC dan untuk adaptor jaringan. Namun, alamat BMC memiliki port unik dan dengan demikian dapat diidentifikasi secara unik di jaringan.
- Contoh format IPv4:
-BMCAddress "10.0.0.21" - Contoh format Ipv6:
-BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829" - Contoh format FQDN:
-BMCAddress "Computer01.Contoso.com" - Contoh format NetBIOS:
-BMCAddress "Computer01"
Catatan: Secara default, VMM menggunakan alamat IP atau FQDN untuk BMCAddress. Namun, dimungkinkan juga untuk membuat modul Windows PowerShell yang memungkinkan Anda menentukan jenis alamat lain sebagai alamat BMC.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BMCCustomConfigurationProvider
Menentukan, atau memperbarui, objek penyedia konfigurasi untuk pengontrol manajemen baseboard (BMC). Penyedia konfigurasi adalah plug-in ke VMM yang menerjemahkan perintah VMM PowerShell ke panggilan API yang khusus untuk jenis pengontrol manajemen baseboard. Anda harus menggunakan parameter ini dengan BMCProtocol Kustom.
| Type: | ConfigurationProvider |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BMCPort
Menentukan, atau memperbarui, port pengontrol manajemen baseboard (BMC) out-of-band untuk komputer fisik tertentu. Port BMC juga dikenal sebagai port prosesor layanan. Contoh port default adalah 623 untuk IPMI dan 443 untuk SMASH melalui WS-Man.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BMCProtocol
Menentukan, atau memperbarui, protokol yang digunakan VMM untuk berkomunikasi dengan pengontrol manajemen baseboard out-of-band (BMC). Nilai yang valid adalah: IPMI, SMASH, Kustom.
BMC (juga dikenal sebagai prosesor layanan atau pengontrol manajemen) adalah pengontrol khusus pada motherboard server yang bertindak antarmuka antara perangkat keras dan perangkat lunak manajemen sistem. Jika motherboard komputer fisik menyertakan BMC, ketika mesin dicolokkan (baik dimatikan atau dinyalakan, dan apakah sistem operasi diinstal), informasi tentang perangkat keras sistem dan status kesehatan perangkat keras sistem tersebut tersedia atau tidak.
Contoh format: -BMCProtocol "Custom"
Catatan: Protokol Kustom mengharuskan Anda menggunakan parameter 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
Menentukan akun Jalankan Sebagai untuk digunakan dengan perangkat pengontrol manajemen baseboard (BMC).
| Type: | RunAsAccount |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BypassADMachineAccountCheck
Menunjukkan bahwa cmdlet ini menggunakan kembali akun komputer yang sudah ada di Direktori Aktif. Secara default, New-SCVMHost memeriksa Direktori Aktif untuk akun yang sudah ada dengan nama yang ditentukan untuk mencegah penimpaan akun komputer.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ComputerName
Menentukan nama komputer yang dapat diidentifikasi secara unik oleh VMM di jaringan Anda. Nilai yang dapat diterima untuk parameter ini adalah:
- FQDN
- Alamat IPv4 atau IPv6
- Nama NetBios
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Menentukan deskripsi untuk host VMM.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IPAddress
Menentukan alamat IPv4 atau IPv6.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Menentukan bahwa kemajuan pekerjaan dilacak dan disimpan dalam variabel yang dinamai oleh parameter ini.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LogicalNetwork
Menentukan jaringan logis. Jaringan logis adalah pengelompokan subnet IP dan VLAN bernama yang digunakan untuk mengatur dan menyederhanakan penetapan jaringan.
| Type: | LogicalNetwork |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ManagementAdapterMACAddress
Menentukan alamat MAC adaptor jaringan fisik pada komputer yang akan digunakan oleh server VMM untuk berkomunikasi dengan host ini.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Menentukan ID tip Performa dan Pengoptimalan Sumber Daya (pro tip) yang memicu tindakan ini. Parameter ini memungkinkan Anda mengaudit tips PRO.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Menunjukkan bahwa pekerjaan berjalan secara asinkron sehingga kontrol segera kembali ke shell perintah.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SMBiosGuid
Menentukan System Management BIOS pengidentifikasi unik global (SMBIOS GUID) untuk komputer fisik yang terkait dengan rekaman untuk komputer fisik tersebut di VMM.
SMBIOS mendefinisikan struktur data dan metode akses yang memungkinkan pengguna atau aplikasi untuk menyimpan dan mengambil informasi tentang perangkat keras di komputer ini, seperti nama sistem, produsen, atau versi BIOS sistem. Windows mendapatkan data SMBIOS saat memulai sistem dan membuat data tersebut tersedia untuk program.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Subnet
Menentukan subnet IP (IPv4 atau IPv6) dalam notasi Classless Inter-Domain Routing (CIDR).
- Contoh format untuk subnet IPv4:
192.168.0.1/24 - Contoh format untuk subnet IPv6:
FD4A:29CD:184F:3A2C::/64
Catatan: Subnet IP tidak dapat tumpang tindih dengan subnet lain dalam grup host atau grup host anak.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMHostConfig
Menentukan objek konfigurasi komputer fisik.
| Type: | PhysicalComputerConfig |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMHostGroup
Menentukan objek grup host komputer virtual.
| Type: | HostGroup |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMHostProfile
Menentukan objek profil host komputer virtual.
| Type: | PhysicalComputerProfile |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMMServer
Menentukan objek server VMM.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Output
Host
Cmdlet ini mengembalikan objek Host .
Catatan
- Memerlukan objek profil host, yang dapat diambil menggunakan cmdlet Get-SCVMHostProfile .