Sdílet prostřednictvím

Set-SCVirtualNetwork

  • Reference
Modul:
VirtualMachineManager

Změní vlastnosti virtuální sítě nakonfigurované na hostiteli spravovaném nástrojem VMM.

Syntaxe

Set-SCVirtualNetwork
   [-VirtualNetwork] <VirtualNetwork>
   [-Name <String>]
   [-Description <String>]
   [-BoundToVMHost <Boolean>]
   [-HostBoundVLanId <UInt16>]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVirtualNetwork
   [-VirtualNetwork] <VirtualNetwork>
   -LogicalSwitch <LogicalSwitch>
   [-VMHostNetworkAdapters <HostNetworkAdapter[]>]
   [-Description <String>]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVirtualNetwork
   [-VirtualNetwork] <VirtualNetwork>
   -LogicalSwitch <LogicalSwitch>
   [-Description <String>]
   [-JobGroup <Guid>]
   [-ConvertToLogicalSwitch]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVirtualNetwork
   [-ClusterVirtualNetwork] <ClusterVirtualNetwork>
   [-Name <String>]
   [-Description <String>]
   [-BoundToVMHost <Boolean>]
   [-HostBoundVLanId <UInt16>]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

Rutina Set-SCVirtualNetwork změní vlastnosti virtuální sítě nakonfigurované na hostiteli spravovaném nástrojem Virtual Machine Manager (VMM).

Mezi vlastnosti virtuální sítě, které můžete změnit, patří:

  • Jakýkoli hostitel. Pro virtuální síť nakonfigurovanou pro virtuální počítače nasazené na libovolném hostiteli podporovaném nástrojem VMM (hostitel Hyper-V, VMware ESX nebo Citrix XenServer) můžete nastavit nebo upravit název nebo popis.

  • pouze hostitel Hyper-V. Pokud je hostitel hostitelem Hyper-V, můžete také nakonfigurovat, jestli jsou virtuální počítače vázané na hostitele (a mají tak přístup k hostitelskému operačnímu systému) a můžete zadat číselný identifikátor virtuální místní sítě (VLAN) na hostiteli.

Příklady

Příklad 1: Zrušení vazby virtuální sítě z hostitele

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com" 
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "InternalVNet01"
PS C:\> Set-SCVirtualNetwork -VirtualNetwork $VirtualNetwork -Name "UnboundVNet01" -BoundToVMHost $False

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 InternalVNet01 z VMHost01 a uloží objekt do proměnné $VirtualNetwork.

Poslední příkaz přejmenuje virtuální síť na UnboundVNet01 a nastaví VMHostBound na $False. Tím zrušíte vazbu virtuální sítě od hostitele, což brání všem virtuálním počítačům připojeným k této virtuální síti v přístupu k hostiteli prostřednictvím této sítě.

Parametry

-BoundToVMHost

Určuje, jestli je virtuální síť svázaná s hostitelem. Vytvoření vazby virtuální sítě k hostiteli umožňuje síťové komunikaci s hostitelem.

Typ:Boolean
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ClusterVirtualNetwork

Určuje objekt virtuální sítě clusteru.

Typ:ClusterVirtualNetwork
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ConvertToLogicalSwitch

Označuje, že tato rutina převede virtuální síť na logický přepínač.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Description

Určuje popis virtuální sítě.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-HostBoundVLanId

Přiřadí síť VLAN virtuálnímu síťovému adaptéru vytvořenému pro hostitele pro zadanou virtuální síť.

Typ:UInt16
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-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

-LogicalSwitch

Určuje objekt logického přepínače.

Typ:LogicalSwitch
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

Určuje název objektu VMM.

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:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-VMHostNetworkAdapters

Určuje pole jednoho nebo více 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: -VMHostNetworkAdapters $VMHostNICs

Typ:HostNetworkAdapter[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Výstupy

VirtualNetwork

Tato rutina vrátí objekt VirtualNetwork.