Udostępnij za pośrednictwem


Set-SCVirtualNetwork

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 (funkcji Hyper-V, VMware ESX lub hosta Citrix XenServer) można ustawić lub zmodyfikować nazwę lub opis.

  • Hyper-V tylko host. Jeśli host jest hostem 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 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 uzyskiwanie dostępu 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.

Typ:Boolean
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ClusterVirtualNetwork

Określa obiekt sieci wirtualnej klastra.

Typ:ClusterVirtualNetwork
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ConvertToLogicalSwitch

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Description

Określa opis sieci wirtualnej.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-HostBoundVLanId

Przypisuje sieć VLAN do wirtualnej karty sieciowej utworzonej dla hosta dla określonej sieci wirtualnej.

Typ:UInt16
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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ń.

Typ:Guid
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-JobVariable

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-LogicalSwitch

Określa obiekt przełącznika logicznego.

Typ:LogicalSwitch
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę obiektu programu VMM.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:Guid
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RunAsynchronously

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-VirtualNetwork

Określa obiekt sieci wirtualnej.

Typ:VirtualNetwork
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-VMHostNetworkAdapters

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

Przykładowy format: -VMHostNetworkAdapters $VMHostNICs

Typ:HostNetworkAdapter[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wyjściowe

VirtualNetwork

To polecenie cmdlet zwraca obiekt VirtualNetwork.