Partilhar via

Set-SCVirtualNetwork

  • Referência
Módulo:
VirtualMachineManager

Altera as propriedades de uma rede virtual configurada em um host gerenciado pelo VMM.

Sintaxe

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

O cmdlet Set-SCVirtualNetwork altera as propriedades de uma rede virtual configurada em um host gerenciado pelo VMM (Virtual Machine Manager).

As propriedades de rede virtual que você pode alterar incluem:

  • Qualquer Host. Para uma rede virtual configurada para máquinas virtuais implantadas em qualquer host compatível com o VMM (um host Hyper-V, VMware ESX ou Citrix XenServer), você pode definir ou modificar o nome ou a descrição.

  • somente Hyper-V host. Se o host for um host Hyper-V, você também poderá configurar se as máquinas virtuais estão associadas ao host (e, portanto, podem acessar o sistema operacional do host) e você pode especificar um identificador numérico para uma VLAN (rede de área local virtual) no host.

Exemplos

Exemplo 1: desassociar uma rede virtual de um 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

O primeiro comando obtém o objeto host chamado VMHost01 e armazena o objeto na variável $VMHost.

O segundo comando obtém o objeto de rede virtual denominado InternalVNet01 do VMHost01 e armazena o objeto na variável $VirtualNetwork.

O último comando renomeia a rede virtual como UnboundVNet01 e define VMHostBound como $False. Isso desvinca a rede virtual do host, o que impede que as máquinas virtuais anexadas a essa rede virtual acessem o host por meio dessa rede.

Parâmetros

-BoundToVMHost

Indica se uma rede virtual está associada a um host. Associar uma rede virtual a um host permite a comunicação de rede com o host.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ClusterVirtualNetwork

Especifica um objeto de rede virtual de cluster.

Tipo:ClusterVirtualNetwork
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ConvertToLogicalSwitch

Indica que esse cmdlet converte a rede virtual em um comutador lógico.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Description

Especifica uma descrição para a rede virtual.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-HostBoundVLanId

Atribui uma VLAN ao adaptador de rede virtual que foi criado para o host para a rede virtual especificada.

Tipo:UInt16
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JobGroup

Especifica um identificador para uma série de comandos que serão executados como um conjunto pouco antes do comando final que inclui o mesmo identificador de grupo de trabalho ser executado.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JobVariable

Especifica que o progresso do trabalho é acompanhado e armazenado na variável nomeada por esse parâmetro.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-LogicalSwitch

Especifica um objeto de comutador lógico.

Tipo:LogicalSwitch
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

Especifica o nome de um objeto do VMM.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PROTipID

Especifica a ID da dica de Otimização de Recursos e Desempenho (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VirtualNetwork

Especifica um objeto de rede virtual.

Tipo:VirtualNetwork
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-VMHostNetworkAdapters

Especifica uma matriz de um ou mais objetos de adaptador de rede física em um host ao qual as máquinas virtuais implantadas nesse host podem se conectar.

Formato de exemplo: -VMHostNetworkAdapters $VMHostNICs

Tipo:HostNetworkAdapter[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Saídas

VirtualNetwork

Esse cmdlet retorna um objeto VirtualNetwork.