Compartir a través de

Set-SCVirtualNetwork

  • Referencia
Módulo:
VirtualMachineManager

Cambia las propiedades de una red virtual configurada en un host administrado por VMM.

Syntax

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

El cmdlet Set-SCVirtualNetwork cambia las propiedades de una red virtual configurada en un host administrado por Virtual Machine Manager (VMM).

Las propiedades de red virtual que puede cambiar incluyen:

  • Cualquier host. Para una red virtual configurada para las máquinas virtuales implementadas en cualquier host compatible con VMM (un host de Hyper-V, VMware ESX o Citrix XenServer), puede establecer o modificar el nombre o la descripción.

  • Solo host de Hyper-V. Si el host es un host de Hyper-V, también puede configurar si las máquinas virtuales están enlazadas al host (y, por tanto, pueden acceder al sistema operativo host) y puede especificar un identificador numérico para una red de área local virtual (VLAN) en el host.

Ejemplos

Ejemplo 1: Desenlace de una red virtual de 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

El primer comando obtiene el objeto host denominado VMHost01 y almacena el objeto en la variable $VMHost.

El segundo comando obtiene el objeto de red virtual denominado InternalVNet01 de VMHost01 y almacena el objeto en la variable $VirtualNetwork.

El último comando cambia el nombre de la red virtual a UnboundVNet01 y establece VMHostBound en $False. Esto desenlaza la red virtual del host, de modo que las máquinas virtuales conectadas a esta red virtual no podrán tener acceso al host a través de esta red.

Parámetros

-BoundToVMHost

Indica si una red virtual está enlazada a un host. El enlace de una red virtual a un host permite la comunicación de red con el host.

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

-ClusterVirtualNetwork

Especifica un objeto de red virtual de clúster.

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

-ConvertToLogicalSwitch

Indica que este cmdlet convierte la red virtual en un conmutador lógico.

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

-Description

Especifica una descripción de la red virtual.

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

-HostBoundVLanId

Asigna una VLAN al adaptador de red virtual que se creó para el host de la red virtual especificada.

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

-JobGroup

Especifica un identificador para una serie de comandos que se ejecutarán como un conjunto antes del comando final que incluye las mismas ejecuciones de identificador de grupo de trabajos.

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

-JobVariable

Especifica que se realiza un seguimiento del progreso del trabajo y que se almacena en la variable cuyo nombre indica este parámetro.

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

-LogicalSwitch

Especifica un objeto de conmutador lógico.

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

-Name

Especifica el nombre de un objeto de VMM.

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

-PROTipID

Especifica el identificador de la sugerencia de optimización de recursos y rendimiento (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar sugerencias pro.

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

-RunAsynchronously

Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva inmediatamente al shell de comandos.

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

-VirtualNetwork

Especifica un objeto de red virtual.

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

-VMHostNetworkAdapters

Especifica una matriz de uno o varios objetos de adaptador de red físico en un host al que pueden conectarse las máquinas virtuales implementadas en dicho host.

Formato de ejemplo: -VMHostNetworkAdapters $VMHostNICs

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

Salidas

VirtualNetwork

Este cmdlet devuelve un objeto VirtualNetwork .