Compartilhar via

Set-SCVirtualNetwork

Módulo:
VirtualMachineManager Module

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

Sintaxe

Host (Padrão) 

Set-SCVirtualNetwork
    [-VirtualNetwork] <VirtualNetwork>
    [-Name <String>]
    [-Description <String>]
    [-BoundToVMHost <Boolean>]
    [-HostBoundVLanId <UInt16>]
    [-JobGroup <Guid>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

LogicalSwitch 

Set-SCVirtualNetwork
    [-VirtualNetwork] <VirtualNetwork>
    -LogicalSwitch <LogicalSwitch>
    [-VMHostNetworkAdapters <HostNetworkAdapter[]>]
    [-Description <String>]
    [-JobGroup <Guid>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

StandardSwitchToLogicalSwitch 

Set-SCVirtualNetwork
    [-VirtualNetwork] <VirtualNetwork>
    -LogicalSwitch <LogicalSwitch>
    [-Description <String>]
    [-JobGroup <Guid>]
    [-ConvertToLogicalSwitch]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Cluster 

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.

  • Hyper-V Somente host. Se o host for um host Hyper-V, você também poderá configurar se as máquinas virtuais estão vinculadas ao host (e, portanto, podem acessar o sistema operacional do host) e poderá especificar um identificador numérico para uma rede local virtual (VLAN) 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 chamado InternalVNet01 de VMHost01 e armazena o objeto na variável $VirtualNetwork.

O último comando renomeia a rede virtual para UnboundVNet01 e define VMHostBound como $False. Isso desassocia a rede virtual do host, o que impede que todas 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. A associação de uma rede virtual a um host permite a comunicação de rede com o host.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Host
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
Cluster
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ClusterVirtualNetwork

Especifica um objeto de rede virtual de cluster.

Propriedades do parâmetro

Tipo:ClusterVirtualNetwork
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Cluster
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ConvertToLogicalSwitch

Indica que esse cmdlet converte a rede virtual em uma opção lógica.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

StandardSwitchToLogicalSwitch
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Description

Especifica uma descrição para a rede virtual.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-HostBoundVLanId

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

Propriedades do parâmetro

Tipo:UInt16
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Host
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
Cluster
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:Guid
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-JobVariable

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-LogicalSwitch

Especifica um objeto de comutador lógico.

Propriedades do parâmetro

Tipo:LogicalSwitch
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

LogicalSwitch
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

Especifica o nome de um objeto do VMM.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Host
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
Cluster
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:Guid
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RunAsynchronously

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-VirtualNetwork

Especifica um objeto de rede virtual.

Propriedades do parâmetro

Tipo:VirtualNetwork
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Host
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
LogicalSwitch
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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

Propriedades do parâmetro

Tipo:

HostNetworkAdapter[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

LogicalSwitch
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Saídas

VirtualNetwork

Esse cmdlet retorna um objeto VirtualNetwork .