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.

Sintaxis

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 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 Hyper-V host. 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 desenlace la red virtual del host, lo que impide que las máquinas virtuales conectadas a esta red virtual accedan 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.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ClusterVirtualNetwork

Especifica un objeto de red virtual de clúster.

Tipo:ClusterVirtualNetwork
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ConvertToLogicalSwitch

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Description

Especifica una descripción de la red virtual.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-HostBoundVLanId

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

Tipo:UInt16
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-JobGroup

Especifica un identificador para una serie de comandos que se ejecutarán como un conjunto justo antes de que se ejecute el mismo identificador de grupo de trabajos.

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-JobVariable

Especifica que se realiza un seguimiento del progreso del trabajo y se almacena en la variable denominada por este parámetro.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-LogicalSwitch

Especifica un objeto de conmutador lógico.

Tipo:LogicalSwitch
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

Especifica el nombre de un objeto VMM.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PROTipID

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

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RunAsynchronously

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VirtualNetwork

Especifica un objeto de red virtual.

Tipo:VirtualNetwork
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-VMHostNetworkAdapters

Especifica una matriz de uno o varios objetos de adaptador de red físicos en un host al que se pueden conectar las máquinas virtuales implementadas en ese host.

Formato de ejemplo: -VMHostNetworkAdapters $VMHostNICs

Tipo:HostNetworkAdapter[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Salidas

VirtualNetwork

Este cmdlet devuelve un objeto VirtualNetwork.