Udostępnij przez


Add-SCVMHostNetworkAdapter

Dodaje fizyczną kartę sieciową na hoście zarządzanym przez program VMM do sieci wirtualnej.

Składnia

Default (Domyślna)

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 tą 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 obejmuje obsługę sieci wirtualnych na potrzeby konfigurowania co najmniej jednej wirtualnej sieci lokalnej (VLAN) na hoście. Za pomocą polecenia cmdlet Add-SCVMHostNetworkAdapter lub polecenia cmdlet Set-SCVMHostNetworkAdapter można skonfigurować pojedynczą 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 karty sieciowej hosta fizycznego 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 $VMHostNetworkAdapter

Pierwsze polecenie pobiera obiekt hosta o nazwie VMHost01 i zapisuje go w zmiennej $VMHost.

Drugie polecenie pobiera obiekt sieci wirtualnej o nazwie ExternalVirtualNetwork01 na VMHost01 i zapisuje obiekt w zmiennej $VirtualNetwork.

Trzecie polecenie pobiera fizyczny obiekt karty sieciowej o nazwie HostAdapter01 na VMHost01 i zapisuje obiekt w zmiennej $VMHostNetworkAdapter.

Ostatnie polecenie dodaje HostAdapter01 do ExternalVirtualNetwork01.

Uwaga: Na każdą sieć wirtualną można dodać tylko jedną fizyczną kartę hosta. 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 karty sieciowej hosta fizycznego do sieci VLAN korzystającej z trybu "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

Pierwsze polecenie pobiera obiekt hosta o nazwie VMHost02 i zapisuje go w zmiennej $VMHost.

Drugie polecenie pobiera obiekt sieci wirtualnej o nazwie ExternalNetwork02 na VMHost02 i zapisuje obiekt w zmiennej $VirtualNetwork.

Trzecie polecenie pobiera obiekt karty sieciowej o nazwie HostAdapter02 w programie VMHost02 i zapisuje obiekt karty w zmiennej $VMHostNetworkAdapter.

Ostatnie polecenie dodaje HostAdapter02 do sieci wirtualnej ExternalNetwork02 i umożliwia dostęp z ExternalNetwork02 do zewnętrznego urządzenia sieciowego przy użyciu sieci VLAN oznaczonych tagiem 802.1Q 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 karty sieciowej hosta fizycznego 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 22

Pierwsze polecenie pobiera obiekt hosta o nazwie VMHost03 i zapisuje go w zmiennej $VMHost.

Drugie polecenie pobiera obiekt sieci wirtualnej o nazwie ExternalNetwork03 na VMHost03 i zapisuje obiekt w zmiennej $VirtualNetwork.

Trzecie polecenie pobiera obiekt karty sieciowej o nazwie HostAdapter03 na VMHost03 i zapisuje obiekt karty w zmiennej $VMHostNetworkAdapter.

Ostatnie polecenie dodaje HostAdapter03 do sieci wirtualnej ExternalNetwork03 i ogranicza dostęp do ExternalNetwork03 do 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ą.

Przestroga: 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 dla serwera 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 adapter sprzężenia zwrotnego firmy Microsoft 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ń.

Właściwości parametru

Typ:Guid
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-JobVariable

Określa, że postęp zadania jest śledzony i przechowywany w zmiennej o nazwie tego parametru.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:Guid
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-RunAsynchronously

Wskazuje, że zadanie jest uruchamiane asynchronicznie, aby kontrolka natychmiast wracała do powłoki poleceń.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-VirtualNetwork

Określa obiekt sieci wirtualnej.

Właściwości parametru

Typ:VirtualNetwork
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-VLanEnabled

Umożliwia korzystanie z wirtualnej sieci LAN (VLAN) przez maszyny wirtualne na hoście Hyper-V lub Citrix XenServer.

Przykładowy format dla pojedynczej sieci VLAN: -VLANEnabled -VLANMode "Access" -VLANID 35 Przykładowy format dla wielu sieci VLAN: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-VLanID

Przypisuje identyfikator numeryczny 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 Hyper-V, VMware ESX lub Citrix XenServer:

-- Na zewnętrznie powiązanej fizycznej karcie sieciowej, gdy tryb VLAN to Access.

Skonfiguruj identyfikator VLanID na wirtualnej karcie sieciowej maszyny wirtualnej:

  • Powiązane z fizyczną kartą sieciową na hoście lub
  • Powiązane z wewnętrzną siecią wirtualną na hoście.

Przykładowy format: -VLanEnabled``-VLanMode "Access" -VLANID 35

Właściwości parametru

Typ:UInt16
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-VLanMode

Określa, czy wirtualna sieć LAN (VLAN) na hoście maszyny wirtualnej obsługuje ruch przez jedną sieć VLAN (tryb dostępu), czy przez wiele sieci VLAN (tryb magistrali). Prawidłowe wartości to: Access, Trunk.

Właściwości parametru

Typ:VlanMode
Domyślna wartość:None
Dopuszczalne wartości:Access, Trunk, Invalid
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-VLanTrunkID

Przypisuje listę identyfikatorów numerycznych z zakresu od 1 do 4094 do fizycznej karty sieciowej na hoście Hyper-V.

Przykładowy format: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124

Właściwości parametru

Typ:

UInt16[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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

Właściwości parametru

Typ:HostNetworkAdapter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:0
Obowiązkowy:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wyjściowe

VMHostNetworkAdapter

To polecenie cmdlet zwraca obiekt VMHostNetworkAdapter .