Add-SCVMHostNetworkAdapter
Přidá fyzický síťový adaptér na hostiteli spravovaném nástrojem VMM do virtuální sítě.
Syntaxe
Add-SCVMHostNetworkAdapter
-VirtualNetwork <VirtualNetwork>
[-VLanEnabled]
[-VLanMode <VlanMode>]
[-VLanID <UInt16>]
[-VLanTrunkID <UInt16[]>]
[-VMHostNetworkAdapter] <HostNetworkAdapter>
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
Description
Rutina Add-SCVMHostNetworkAdapter přidá fyzický síťový adaptér (označovaný také jako síťová karta) na hostiteli spravovaném nástrojem Virtual Machine Manager (VMM) do virtuální sítě. Každý virtuální počítač na daném hostiteli se také může připojit přes virtuální síťový adaptér k této virtuální síti.
Virtuální síť nakonfigurovaná na hostiteli se může připojit k více virtuálním síťovým adaptérům na virtuálních počítačích nasazených na daném hostiteli.
Nástroj VMM pro System Center 2019 a novější zahrnuje podporu virtuálních sítí pro konfiguraci jedné nebo více sítí VLAN (Virtual Local Area Networks) na hostiteli.
Ke konfiguraci jedné sítě VLAN nebo několika sítí VLAN na hostiteli můžete použít
Obrázek každého typu sítě VLAN najdete v příkladech této rutiny.
Příklady
Příklad 1: Přidání síťového adaptéru fyzického hostitele do virtuální sítě
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
První příkaz načte objekt hostitele s názvem VMHost01 a uloží objekt do proměnné $VMHost.
Druhý příkaz získá objekt virtuální sítě s názvem ExternalVirtualNetwork01 na VMHost01 a uloží objekt do proměnné $VirtualNetwork.
Třetí příkaz získá objekt fyzického síťového adaptéru s názvem HostAdapter01 na VMHost01 a uloží objekt do proměnné $VMHostNetworkAdapter.
Poslední příkaz přidá HostAdapter01 do ExternalVirtualNetwork01.
Poznámka: Pro každou virtuální síť můžete přidat pouze jeden fyzický hostitelský adaptér. Poslední příkaz proto selže, pokud je adaptér již přidružený k zadané virtuální síti. Pokud chcete do virtuální sítě přidat nový adaptér, musíte nejprve odebrat existující hostitelský adaptér.
Příklad 2: Přidání síťového adaptéru fyzického hostitele do sítě VLAN, která používá režim 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
První příkaz získá objekt hostitele s názvem VMHost02 a uloží objekt do $VMHost proměnné.
Druhý příkaz získá objekt virtuální sítě s názvem ExternalNetwork02 na VMHost02 a uloží objekt do proměnné $VirtualNetwork.
Třetí příkaz získá objekt síťového adaptéru s názvem HostAdapter02 na VMHost02 a uloží objekt adaptéru do proměnné $VMHostNetworkAdapter.
Poslední příkaz přidá HostAdapter02 do virtuální sítě ExternalNetwork02 a povolí přístup z ExternalNetwork02 k externímu síťovému zařízení pomocí sítí 802.1Q označených sítí VLAN 1, 2, 100, 200 a 1124.
Poznámka: Pro každou virtuální síť můžete přidat pouze jeden hostitelský adaptér, takže poslední příkaz selže, pokud je adaptér již přidružený k zadané virtuální síti.
Příklad 3: Přidání síťového adaptéru fyzického hostitele do sítě VLAN, která používá režim Přístupu
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
První příkaz získá objekt hostitele s názvem VMHost03 a uloží objekt do proměnné $VMHost.
Druhý příkaz získá objekt virtuální sítě s názvem ExternalNetwork03 na VMHost03 a uloží objekt do proměnné $VirtualNetwork.
Třetí příkaz získá objekt síťového adaptéru s názvem HostAdapter03 na VMHost03 a uloží objekt adaptéru do proměnné $VMHostNetworkAdapter.
Poslední příkaz přidá HostAdapter03 do virtuální sítě ExternalNetwork03 a omezí přístup k ExternalNetwork03 na VLANID 22.
Poznámka: Pro každou virtuální síť můžete přidat pouze jeden hostitelský adaptér, takže poslední příkaz selže, pokud je adaptér již přidružený k zadané virtuální síti.
Upozornění: V tomto příkladu se předpokládá, že váš hostitel je již připojený k síti VLAN, nebo pokud ne, ujistěte se, že váš hostitel má dva síťové adaptéry. Pokud má váš hostitel jeden síťový adaptér, přiřazení adaptéru k síti VLAN, která není k dispozici serveru VMM, zabrání nástroji VMM ve správě hostitele. Kroky v tomto příkladu můžete provést na hostiteli, který má pouze jeden síťový adaptér, pokud na server poprvé nainstalujete adaptér Microsoft Loopback Adapter.
Parametry
-JobGroup
Určuje identifikátor pro řadu příkazů, které se spustí jako sada těsně před posledním příkazem, který obsahuje stejné spuštění identifikátoru skupiny úloh.
Typ: | Guid |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-JobVariable
Určuje, že průběh úlohy je sledován a uložen v proměnné pojmenované tímto parametrem.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-PROTipID
Určuje ID tipu pro optimalizaci výkonu a prostředků (TIP PRO), který tuto akci aktivoval. Tento parametr umožňuje auditovat tipy PRO.
Typ: | Guid |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-RunAsynchronously
Označuje, že úloha běží asynchronně, aby se ovládací prvek okamžitě vrátil do příkazového prostředí.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-VirtualNetwork
Určuje objekt virtuální sítě.
Typ: | VirtualNetwork |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-VLanEnabled
Povolí virtuální síť LAN (VLAN) pro použití virtuálními počítači na hostiteli Hyper-V nebo Citrix XenServer.
Příklad formátu pro jednu síť VLAN: -VLANEnabled -VLANMode "Access" -VLANID 35
Příklad formátu pro více sítí VLAN: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-VLanID
Přiřadí číselný identifikátor v rozsahu 1–4094 virtuálnímu síťovému adaptéru na virtuálním počítači nebo fyzickému síťovému adaptéru na hostiteli virtuálního počítače.
Nakonfigurujte VLanID na hostiteli Hyper-V, VMware ESX nebo Citrix XenServer:
-- Na externě vázaném fyzickém síťovém adaptéru, když je režim VLan Access.
Konfigurace VLanID na virtuálním síťovém adaptéru virtuálního počítače:
- Svázaný s fyzickým síťovým adaptérem na hostiteli nebo
- Svázaná s interní virtuální sítí na hostiteli.
Příklad formátu: -VLanEnabled``-VLanMode "Access" -VLANID 35
Typ: | UInt16 |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-VLanMode
Určuje, jestli virtuální síť LAN (VLAN) na hostiteli virtuálního počítače podporuje provoz přes jednu síť VLAN (režim přístupu) nebo více sítí VLAN (režim kmene). Platné hodnoty jsou: Access, Trunk.
Typ: | VlanMode |
Přípustné hodnoty: | Access, Trunk, Invalid |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-VLanTrunkID
Přiřadí seznam číselných identifikátorů v rozsahu 1–4094 fyzickému síťovému adaptéru na Hyper-V hostiteli.
Příklad formátu: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
Typ: | UInt16[] |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-VMHostNetworkAdapter
Určuje objekt fyzického síťového adaptéru na hostiteli, ke kterému se můžou připojit virtuální počítače nasazené na daném hostiteli.
Příklad formátu: -VMHostNetworkAdapter $VMHostNIC
Typ: | HostNetworkAdapter |
Position: | 0 |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
Výstupy
VMHostNetworkAdapter
Tato rutina vrátí objekt VMHostNetworkAdapter.