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.

  • Solo host Hyper-V. Se l'host è un host Hyper-V, è anche possibile configurare se le macchine virtuali sono associate all'host (e quindi possono 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. Rimuove il binding della rete virtuale dall'host, impedendo a tutte le macchine virtuali collegate a tale rete virtuale di accedere all'host tramite la 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.

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

-ClusterVirtualNetwork

Specifica un oggetto di rete virtuale del cluster.

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

-ConvertToLogicalSwitch

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

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

-Description

Specifica una descrizione per la rete virtuale.

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

-HostBoundVLanId

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

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

-JobGroup

Specifica un identificatore per una serie di comandi che verranno eseguiti come un insieme prima dell'esecuzione dell'ultimo comando che include lo stesso identificatore di gruppo di processi.

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

-JobVariable

Specifica che lo stato del processo viene monitorato e archiviato nella variabile indicata in questo parametro.

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

-LogicalSwitch

Specifica un oggetto commutatore logico.

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

-Name

Specifica il nome di un oggetto di VMM.

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

-PROTipID

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

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

-RunAsynchronously

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

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

-VirtualNetwork

Specifica un oggetto rete virtuale.

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

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

Output

VirtualNetwork

Questo cmdlet restituisce un oggetto VirtualNetwork .