Udostępnij za pośrednictwem

Set-SCVirtualNetwork

  • Odwołanie
Moduł:
VirtualMachineManager

Zmienia właściwości sieci wirtualnej skonfigurowanej na hoście zarządzanym przez program VMM.

Składnia

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>]

Opis

Polecenie cmdlet Set-SCVirtualNetwork zmienia właściwości sieci wirtualnej skonfigurowanej na hoście zarządzanym przez program Virtual Machine Manager (VMM).

Właściwości sieci wirtualnej, które można zmienić, obejmują:

  • Dowolny host. W przypadku sieci wirtualnej skonfigurowanej dla maszyn wirtualnych wdrożonych na dowolnym hoście obsługiwanym przez program VMM (host funkcji Hyper-V, VMware ESX lub Citrix XenServer) można ustawić lub zmodyfikować nazwę lub opis.

  • Tylko host funkcji Hyper-V. Jeśli host jest hostem funkcji Hyper-V, możesz również skonfigurować, czy maszyny wirtualne są powiązane z hostem (i w związku z tym mogą uzyskiwać dostęp do systemu operacyjnego hosta), a także określić identyfikator liczbowy dla wirtualnej sieci lokalnej (VLAN) na hoście.

Przykłady

Przykład 1. Usuwanie powiązania sieci wirtualnej z hosta

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

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

Drugie polecenie pobiera obiekt sieci wirtualnej o nazwie InternalVNet01 z vmHost01 i przechowuje obiekt w zmiennej $VirtualNetwork.

Ostatnie polecenie zmienia nazwę sieci wirtualnej na UnboundVNet01 i ustawia wartość VMHostBound na $False. Spowoduje to usunięcie powiązania sieci wirtualnej z hosta, co uniemożliwia wszystkim maszynom wirtualnym dołączonym do tej sieci wirtualnej dostęp do hosta za pośrednictwem tej sieci.

Parametry

-BoundToVMHost

Wskazuje, czy sieć wirtualna jest powiązana z hostem. Powiązanie sieci wirtualnej z hostem umożliwia komunikację sieciową z hostem.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClusterVirtualNetwork

Określa obiekt sieci wirtualnej klastra.

Type:ClusterVirtualNetwork
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ConvertToLogicalSwitch

Wskazuje, że to polecenie cmdlet konwertuje sieć wirtualną na przełącznik logiczny.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Description

Określa opis sieci wirtualnej.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HostBoundVLanId

Przypisuje sieć VLAN do wirtualnej karty sieciowej, która została utworzona dla hosta dla określonej sieci wirtualnej.

Type:UInt16
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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

-LogicalSwitch

Określa obiekt przełącznika logicznego.

Type:LogicalSwitch
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Określa nazwę obiektu programu VMM.

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:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMHostNetworkAdapters

Określa tablicę co najmniej jednego fizycznego obiektu karty sieciowej na hoście, z którym mogą się łączyć maszyny wirtualne wdrożone na tym hoście.

Przykładowy format: -VMHostNetworkAdapters $VMHostNICs

Type:HostNetworkAdapter[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Dane wyjściowe

VirtualNetwork

To polecenie cmdlet zwraca obiekt VirtualNetwork .