Add-SCVMHostNetworkAdapter
Dodaje fizyczną kartę sieciową na hoście zarządzanym przez program VMM do sieci wirtualnej.
Składnia
Add-SCVMHostNetworkAdapter
-VirtualNetwork <VirtualNetwork>
[-VLanEnabled]
[-VLanMode <VlanMode>]
[-VLanID <UInt16>]
[-VLanTrunkID <UInt16[]>]
[-VMHostNetworkAdapter] <HostNetworkAdapter>
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Opis
Polecenie cmdlet Add-SCVMHostNetworkAdapter dodaje fizyczną kartę sieciową (nazywaną również kartą sieciową lub kartą sieciową) na hoście zarządzanym przez program Virtual Machine Manager (VMM) do sieci wirtualnej. Każda maszyna wirtualna na tym hoście może również łączyć się za pośrednictwem wirtualnej karty sieciowej z siecią wirtualną.
Sieć wirtualna skonfigurowana na hoście może łączyć się z wieloma wirtualnymi kartami sieciowymi na maszynach wirtualnych wdrożonych na tym hoście.
Program VMM dla programu System Center 2019 i nowszych zawiera obsługę sieci wirtualnych na potrzeby konfigurowania co najmniej jednej wirtualnej sieci lokalnej (VLAN) na hoście. Możesz użyć polecenia cmdlet Add-SCVMHostNetworkAdapter lub polecenia cmdlet Set-SCVMHostNetworkAdapter , aby skonfigurować jedną sieć VLAN lub wiele sieci VLAN na hoście. Aby skonfigurować odpowiednie ustawienia sieci VLAN na maszynie wirtualnej, użyj polecenia cmdlet New-SCVirtualNetworkAdapter lub polecenia cmdlet Set-SCVirtualNetworkAdapter .
Aby zapoznać się z ilustracją każdego typu sieci VLAN, zobacz przykłady tego polecenia cmdlet.
Przykłady
Przykład 1: Dodawanie fizycznej karty sieciowej hosta do sieci wirtualnej
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 $VMHostNetworkAdapterPierwsze polecenie pobiera obiekt hosta o nazwie VMHost01 i przechowuje obiekt w zmiennej $VMHost.
Drugie polecenie pobiera obiekt sieci wirtualnej o nazwie ExternalVirtualNetwork01 na vmHost01 i przechowuje obiekt w zmiennej $VirtualNetwork.
Trzecie polecenie pobiera fizyczny obiekt karty sieciowej o nazwie HostAdapter01 na vmHost01 i przechowuje obiekt w zmiennej $VMHostNetworkAdapter.
Ostatnie polecenie dodaje element HostAdapter01 do elementu ExternalVirtualNetwork01.
Uwaga: można dodać tylko jedną fizyczną kartę hosta na sieć wirtualną. W związku z tym ostatnie polecenie zakończy się niepowodzeniem, jeśli karta jest już skojarzona z określoną siecią wirtualną. Aby dodać nową kartę do sieci wirtualnej, należy najpierw usunąć istniejącą kartę hosta.
Przykład 2: Dodawanie fizycznej karty sieciowej hosta do sieci VLAN korzystającej z trybu "Magistrala"
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,1124Pierwsze polecenie pobiera obiekt hosta o nazwie VMHost02 i przechowuje obiekt w zmiennej $VMHost.
Drugie polecenie pobiera obiekt sieci wirtualnej o nazwie ExternalNetwork02 na maszynie wirtualnej VMHost02 i przechowuje obiekt w zmiennej $VirtualNetwork.
Trzecie polecenie pobiera obiekt karty sieciowej o nazwie HostAdapter02 na vmHost02 i przechowuje obiekt karty w zmiennej $VMHostNetworkAdapter.
Ostatnie polecenie dodaje hostAdapter02 do sieci wirtualnej ExternalNetwork02 i umożliwia dostęp z zewnętrznego urządzenia sieciowego przy użyciu 802.1Q oznakowanych sieci VLAN 1, 2, 100, 200 i 1124.
Uwaga: można dodać tylko jedną kartę hosta na sieć wirtualną, więc ostatnie polecenie zakończy się niepowodzeniem, jeśli karta jest już skojarzona z określoną siecią wirtualną.
Przykład 3: Dodawanie fizycznej karty sieciowej hosta do sieci VLAN korzystającej z trybu "Dostęp"
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 22Pierwsze polecenie pobiera obiekt hosta o nazwie VMHost03 i przechowuje obiekt w zmiennej $VMHost.
Drugie polecenie pobiera obiekt sieci wirtualnej o nazwie ExternalNetwork03 na maszynie wirtualnej VMHost03 i przechowuje obiekt w zmiennej $VirtualNetwork.
Trzecie polecenie pobiera obiekt karty sieciowej o nazwie HostAdapter03 na vmHost03 i przechowuje obiekt karty w zmiennej$VMHostNetworkAdapter.
Ostatnie polecenie dodaje hostAdapter03 do sieci wirtualnej ExternalNetwork03 i ogranicza dostęp do elementu ExternalNetwork03 do identyfikatora VLANID 22.
Uwaga: można dodać tylko jedną kartę hosta na sieć wirtualną, więc ostatnie polecenie zakończy się niepowodzeniem, jeśli karta jest już skojarzona z określoną siecią wirtualną.
Uwaga: W tym przykładzie założono, że host jest już połączony z siecią VLAN lub, jeśli nie, upewnij się, że host ma dwie karty sieciowe. Jeśli host ma jedną kartę sieciową, przypisanie karty do sieci VLAN, która jest niedostępna na serwerze programu VMM, uniemożliwi programowi VMM zarządzanie hostem. Kroki opisane w tym przykładzie można wykonać na hoście, który ma tylko jedną kartę sieciową, jeśli najpierw zainstalujesz kartę Microsoft Loopback na serwerze.
Parametry
-JobGroup
Określa identyfikator serii poleceń, które będą uruchamiane jako zestaw tuż przed ostatnim poleceniem zawierającym ten sam identyfikator grupy zadań.
| Type: | Guid |
| 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 |
-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 |
-VirtualNetwork
Określa obiekt sieci wirtualnej.
| Type: | VirtualNetwork |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VLanEnabled
Umożliwia używanie wirtualnej sieci LAN (VLAN) przez maszyny wirtualne na hoście funkcji Hyper-V lub Citrix XenServer.
Przykładowy format pojedynczej sieci VLAN: -VLANEnabled -VLANMode "Access" -VLANID 35 przykładowy format wielu sieci 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
Przypisuje identyfikator liczbowy z zakresu od 1 do 4094 do wirtualnej karty sieciowej na maszynie wirtualnej lub do fizycznej karty sieciowej na hoście maszyny wirtualnej.
Skonfiguruj identyfikator VLanID na hoście funkcji Hyper-V, VMware ESX lub Citrix XenServer:
-- Na zewnętrznej powiązanej fizycznej karcie sieciowej, gdy tryb VLan ma wartość Access.
Skonfiguruj identyfikator VLanID na wirtualnej karcie sieciowej maszyny wirtualnej:
- Powiązana z fizyczną kartą sieciową na hoście lub
- Powiązana z wewnętrzną siecią wirtualną na hoście.
Przykładowy format: -VLanEnabled``-VLanMode "Access" -VLANID 35
| Type: | UInt16 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VLanMode
Określa, czy wirtualna sieć LAN (VLAN) na hoście maszyny wirtualnej obsługuje ruch w jednej sieci VLAN (tryb dostępu) lub w wielu sieciach VLAN (tryb magistrali). Prawidłowe wartości to: Dostęp, Magistrala.
| Type: | VlanMode |
| Accepted values: | Access, Trunk, Invalid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VLanTrunkID
Przypisuje listę identyfikatorów liczbowych w zakresie od 1 do 4094 do fizycznej karty sieciowej na hoście funkcji Hyper-V.
Przykładowy 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
Określa fizyczny obiekt karty sieciowej na hoście, z którym mogą łączyć się maszyny wirtualne wdrożone na tym hoście.
Przykładowy format: -VMHostNetworkAdapter $VMHostNIC
| Type: | HostNetworkAdapter |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Dane wyjściowe
VMHostNetworkAdapter
To polecenie cmdlet zwraca obiekt VMHostNetworkAdapter .