Add-SCVMHostNetworkAdapter
Menambahkan adaptor jaringan fisik pada host yang dikelola oleh VMM ke jaringan virtual.
Sintaks
Add-SCVMHostNetworkAdapter
-VirtualNetwork <VirtualNetwork>
[-VLanEnabled]
[-VLanMode <VlanMode>]
[-VLanID <UInt16>]
[-VLanTrunkID <UInt16[]>]
[-VMHostNetworkAdapter] <HostNetworkAdapter>
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
Deskripsi
Cmdlet Add-SCVMHostNetworkAdapter menambahkan adaptor jaringan fisik (juga disebut kartu antarmuka jaringan, atau NIC) pada host yang dikelola oleh Virtual Machine Manager (VMM) ke jaringan virtual. Setiap komputer virtual pada host tersebut juga dapat terhubung melalui adaptor jaringan virtual ke jaringan virtual tersebut.
Jaringan virtual yang dikonfigurasi pada host dapat terhubung ke beberapa adaptor jaringan virtual pada komputer virtual yang disebarkan pada host tersebut.
VMM untuk System Center 2019 mencakup dukungan jaringan virtual untuk mengonfigurasi satu atau beberapa Virtual Local Area Networks (VLAN) pada host. Anda dapat menggunakan cmdlet Add-SCVMHostNetworkAdapter atau cmdlet Set-SCVMHostNetworkAdapter untuk mengonfigurasi satu VLAN atau beberapa VLAN pada host. Untuk mengonfigurasi pengaturan VLAN yang sesuai pada komputer virtual, gunakan cmdlet New-SCVirtualNetworkAdapter atau cmdlet Set-SCVirtualNetworkAdapter .
Untuk ilustrasi setiap jenis VLAN, lihat contoh untuk cmdlet ini.
Contoh
Contoh 1: Menambahkan adaptor jaringan host fisik ke jaringan virtual
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalVirtualNetwork01"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter01"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter
Perintah pertama mendapatkan objek host bernama VMHost01 dan menyimpan objek dalam variabel $VMHost.
Perintah kedua mendapatkan objek jaringan virtual bernama ExternalVirtualNetwork01 di VMHost01 dan menyimpan objek dalam variabel $VirtualNetwork.
Perintah ketiga mendapatkan objek adaptor jaringan fisik bernama HostAdapter01 di VMHost01 dan menyimpan objek dalam variabel $VMHostNetworkAdapter.
Perintah terakhir menambahkan HostAdapter01 ke ExternalVirtualNetwork01.
Catatan: Anda hanya dapat menambahkan satu adaptor host fisik per jaringan virtual. Oleh karena itu, perintah terakhir akan gagal jika adaptor sudah dikaitkan dengan jaringan virtual yang ditentukan. Untuk menambahkan adaptor baru ke jaringan virtual, Anda harus terlebih dahulu menghapus adaptor host yang ada.
Contoh 2: Menambahkan adaptor jaringan host fisik ke VLAN yang menggunakan mode "Trunk"
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost02"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalNetwork02"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter02"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
Perintah pertama mendapatkan objek host bernama VMHost02 dan menyimpan objek dalam variabel $VMHost.
Perintah kedua mendapatkan objek jaringan virtual bernama ExternalNetwork02 di VMHost02 dan menyimpan objek dalam variabel $VirtualNetwork.
Perintah ketiga mendapatkan objek adaptor jaringan bernama HostAdapter02 di VMHost02 dan menyimpan objek adaptor dalam variabel $VMHostNetworkAdapter.
Perintah terakhir menambahkan HostAdapter02 ke jaringan virtual ExternalNetwork02 dan memungkinkan akses dari ExternalNetwork02 ke perangkat jaringan eksternal menggunakan VLAN yang ditandai 802.1Q 1, 2, 100, 200, dan 1124.
Catatan: Anda hanya dapat menambahkan satu adaptor host per jaringan virtual, sehingga perintah terakhir akan gagal jika adaptor sudah dikaitkan dengan jaringan virtual yang ditentukan.
Contoh 3: Menambahkan adaptor jaringan host fisik ke VLAN yang menggunakan mode "Access"
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost03.Contoso.com"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalVirtualNetwork03"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter03"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter -VLanEnabled -VLanMode "Access" -VLanID 22
Perintah pertama mendapatkan objek host bernama VMHost03 dan menyimpan objek dalam variabel $VMHost.
Perintah kedua mendapatkan objek jaringan virtual bernama ExternalNetwork03 di VMHost03 dan menyimpan objek dalam variabel $VirtualNetwork.
Perintah ketiga mendapatkan objek adaptor jaringan bernama HostAdapter03 di VMHost03 dan menyimpan objek adaptor dalam variabel$VMHostNetworkAdapter.
Perintah terakhir menambahkan HostAdapter03 ke jaringan virtual ExternalNetwork03 dan membatasi akses ke ExternalNetwork03 ke VLANID 22.
Catatan: Anda hanya dapat menambahkan satu adaptor host per jaringan virtual, sehingga perintah terakhir akan gagal jika adaptor sudah dikaitkan dengan jaringan virtual yang ditentukan.
Perhatian: Contoh ini mengasumsikan bahwa host Anda sudah terhubung ke VLAN atau, jika tidak, pastikan bahwa host Anda memiliki dua adaptor jaringan. Jika host Anda memiliki adaptor jaringan tunggal, menetapkan adaptor ke VLAN yang tidak tersedia untuk server VMM akan mencegah VMM mengelola host. Anda dapat melakukan langkah-langkah dalam contoh ini pada host yang hanya memiliki satu adaptor jaringan jika Anda pertama kali menginstal Microsoft Loopback Adapter di server Anda.
Parameter
-JobGroup
Menentukan pengidentifikasi untuk serangkaian perintah yang akan berjalan sebagai set tepat sebelum perintah akhir yang menyertakan pengidentifikasi grup pekerjaan yang sama berjalan.
Type: | Guid |
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 |
-PROTipID
Menentukan ID tip Performa dan Pengoptimalan Sumber Daya (tip PRO) 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 |
-VirtualNetwork
Menentukan objek jaringan virtual.
Type: | VirtualNetwork |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VLanEnabled
Mengaktifkan LAN virtual (VLAN) untuk digunakan oleh komputer virtual pada host Hyper-V atau Citrix XenServer.
Contoh format untuk satu VLAN: -VLANEnabled -VLANMode "Access" -VLANID 35
Contoh format untuk beberapa VLAN: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VLanID
Menetapkan pengidentifikasi numerik dalam rentang 1-4094 ke adaptor jaringan virtual pada komputer virtual atau ke adaptor jaringan fisik pada host komputer virtual.
Konfigurasikan VLanID pada host Hyper-V, VMware ESX, atau Citrix XenServer:
-- Pada adaptor jaringan fisik yang terikat secara eksternal saat mode VLan adalah Access.
Konfigurasikan VLanID pada adaptor jaringan virtual komputer virtual:
- Terikat ke adaptor jaringan fisik pada host, atau
- Terikat ke jaringan virtual internal pada host.
Contoh format: -VLanEnabled``-VLanMode "Access" -VLANID 35
Type: | UInt16 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VLanMode
Menentukan apakah LAN virtual (VLAN) pada host komputer virtual mendukung lalu lintas di satu VLAN (Mode akses) atau di beberapa VLAN (mode Trunk). Nilai yang valid adalah: Access, Trunk.
Type: | VlanMode |
Accepted values: | Access, Trunk, Invalid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VLanTrunkID
Menetapkan daftar pengidentifikasi numerik dalam rentang 1-4094 ke adaptor jaringan fisik pada host Hyper-V.
Contoh format: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
Type: | UInt16[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMHostNetworkAdapter
Menentukan objek adaptor jaringan fisik pada host tempat komputer virtual yang disebarkan pada host tersebut dapat terhubung.
Contoh format: -VMHostNetworkAdapter $VMHostNIC
Type: | HostNetworkAdapter |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Output
VMHostNetworkAdapter
Cmdlet ini mengembalikan objek VMHostNetworkAdapter .