Condividi tramite

Set-SCVirtualNetwork

  • Riferimento
Modulo:
VirtualMachineManager

Modifica le proprietà di una rete virtuale configurata in un host gestito da VMM.

Sintassi

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

Descrizione

Il cmdlet Set-SCVirtualNetwork modifica le proprietà di una rete virtuale configurata in un host gestito da Virtual Machine Manager (VMM).

Le proprietà della rete virtuale che è possibile modificare includono:

  • Qualsiasi host. Per una rete virtuale configurata per le macchine virtuali distribuite in qualsiasi host supportato da VMM (un host Hyper-V, VMware ESX o Citrix XenServer), è possibile impostare o modificare il nome o la descrizione.

  • Hyper-V solo host. Se l'host è un host Hyper-V, è anche possibile configurare se le macchine virtuali sono associate all'host (e possono quindi accedere al sistema operativo host) ed è possibile specificare un identificatore numerico per una rete locale virtuale (VLAN) nell'host.

Esempio

Esempio 1: Annullare l'associazione di una rete virtuale da un host

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

Il primo comando ottiene l'oggetto host denominato VMHost01 e archivia l'oggetto nella variabile $VMHost.

Il secondo comando ottiene l'oggetto di rete virtuale denominato InternalVNet01 da VMHost01 e archivia l'oggetto nella variabile $VirtualNetwork.

L'ultimo comando rinomina la rete virtuale in UnboundVNet01 e imposta VMHostBound su $False. Questa operazione annulla l'associazione della rete virtuale dall'host, che impedisce a tutte le macchine virtuali collegate a questa rete virtuale di accedere all'host tramite questa rete.

Parametri

-BoundToVMHost

Indica se una rete virtuale è associata a un host. L'associazione di una rete virtuale a un host consente la comunicazione di rete con l'host.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ClusterVirtualNetwork

Specifica un oggetto di rete virtuale del cluster.

Tipo:ClusterVirtualNetwork
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ConvertToLogicalSwitch

Indica che questo cmdlet converte la rete virtuale in un commutatore logico.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Description

Specifica una descrizione per la rete virtuale.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-HostBoundVLanId

Assegna una VLAN alla scheda di rete virtuale creata per l'host per la rete virtuale specificata.

Tipo:UInt16
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-JobGroup

Specifica un identificatore per una serie di comandi che verranno eseguiti come set subito prima dell'esecuzione del comando finale che include lo stesso identificatore del gruppo di processi.

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-JobVariable

Specifica che lo stato del processo viene rilevato e archiviato nella variabile denominata da questo parametro.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-LogicalSwitch

Specifica un oggetto switch logico.

Tipo:LogicalSwitch
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specifica il nome di un oggetto VMM.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PROTipID

Specifica l'ID del suggerimento per le prestazioni e l'ottimizzazione risorse (suggerimento PRO) che ha attivato questa azione. Questo parametro consente di controllare i suggerimenti pro.

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RunAsynchronously

Indica che il processo viene eseguito in modo asincrono in modo che il controllo torni immediatamente alla shell dei comandi.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-VirtualNetwork

Specifica un oggetto di rete virtuale.

Tipo:VirtualNetwork
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-VMHostNetworkAdapters

Specifica una matrice di uno o più oggetti scheda di rete fisica in un host a cui possono connettersi le macchine virtuali distribuite in tale host.

Formato di esempio: -VMHostNetworkAdapters $VMHostNICs

Tipo:HostNetworkAdapter[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Output

VirtualNetwork

Questo cmdlet restituisce un oggetto VirtualNetwork .