Partilhar via

Set-SCVirtualNetwork

  • Referência
Módulo:
VirtualMachineManager

Altera as propriedades de uma rede virtual configurada num hospedeiro gerido 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

O cmdlet Set-SCVirtualNetwork altera as propriedades de uma rede virtual configurada num hospedeiro gerido pelo Virtual Machine Manager (VMM).

As propriedades de rede virtual que pode alterar incluem:

  • Qualquer anfitrião. Para uma rede virtual configurada para máquinas virtuais implantadas em qualquer anfitrião suportado por VMM (um anfitrião Hyper-V, VMware ESX ou Citrix XenServer), pode definir ou modificar o nome ou descrição.

  • Só hospedeiro hiper-V. Se o hospedeiro for um anfitrião Hiper-V, também pode configurar se as máquinas virtuais estão ligadas ao hospedeiro (e pode assim aceder ao sistema operativo do anfitrião), e pode especificar um identificador numérico para uma rede de área local virtual (VLAN) no hospedeiro.

Exemplos

Exemplo 1: Desvinga uma rede virtual de um anfitrião

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 recebe o objeto anfitrião chamado VMHost01 e armazena o objeto na variável $VMHost.

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

O último comando renomea a rede virtual para UnboundVNet01 e define vMHostBound para $False. Isto desvinga a rede virtual do hospedeiro, o que impede que quaisquer máquinas virtuais que estejam ligadas a esta rede virtual acedam ao hospedeiro através desta rede.

Parâmetros

-BoundToVMHost

Indica se uma rede virtual está ligada a um hospedeiro. A ligação de uma rede virtual a um anfitrião permite a comunicação da rede ao anfitrião.

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

-ClusterVirtualNetwork

Especifica um objeto de rede virtual de cluster.

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

-ConvertToLogicalSwitch

Indica que este cmdlet converte a rede virtual num interruptor lógico.

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

-Description

Especifica uma descrição para a rede virtual.

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

-HostBoundVLanId

Atribui um VLAN ao adaptador de rede virtual que foi criado para o anfitrião para a rede virtual especificada.

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

-JobGroup

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

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

-JobVariable

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

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

-LogicalSwitch

Especifica um objeto de comutação lógico.

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

-Name

Especifica o nome de um objeto VMM.

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

-PROTipID

Especifica o ID da ponta de otimização de desempenho e recursos (ponta PRO) que desencadeou esta ação. Este parâmetro permite-lhe auditar dicas PRO.

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

-RunAsynchronously

Indica que o trabalho funciona assíncronamente para que o controlo volte imediatamente à concha de comando.

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

-VirtualNetwork

Especifica um objeto de rede virtual.

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

-VMHostNetworkAdapters

Especifica uma matriz de um ou mais objetos adaptadores de rede física num hospedeiro ao qual as máquinas virtuais implantadas nesse hospedeiro podem ligar-se.

Formato de exemplo: -VMHostNetworkAdapters $VMHostNICs

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

Saídas

VirtualNetwork

Este cmdlet devolve um objeto VirtualNetwork .