O cmdlet Set-SCVirtualNetwork altera as propriedades de uma rede virtual configurada em um host gerenciado pelo Virtual Machine Manager (VMM).
As propriedades de rede virtual que você pode alterar incluem:
Qualquer anfitrião.
Para uma rede virtual configurada para máquinas virtuais implantadas em qualquer host suportado pelo VMM (um host Hyper-V, VMware ESX ou Citrix XenServer), você pode definir ou modificar o nome ou a descrição.
Hyper-V apenas 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, poderá acessar o sistema operacional do host) e especificar um identificador numérico para uma rede local virtual (VLAN) no host.
Exemplos
Exemplo 1: Desvincular uma rede virtual de um host
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 desvincula a rede virtual do host, o que impede que quaisquer máquinas virtuais conectadas a essa rede virtual acessem o host por meio dessa rede.
Parâmetros
-BoundToVMHost
Indica se uma rede virtual está vinculada a um host.
Vincular uma rede virtual a um host permite a comunicação de rede com o host.
Propriedades dos parâmetros
Tipo:
Boolean
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
Host
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
Cluster
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-ClusterVirtualNetwork
Especifica um objeto de rede virtual de cluster.
Propriedades dos parâmetros
Tipo:
ClusterVirtualNetwork
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
Cluster
Position:
0
Obrigatório:
True
Valor do pipeline:
True
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-ConvertToLogicalSwitch
Indica que esse cmdlet converte a rede virtual em um comutador lógico.
Propriedades dos parâmetros
Tipo:
SwitchParameter
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
StandardSwitchToLogicalSwitch
Position:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-Description
Especifica uma descrição para a rede virtual.
Propriedades dos parâmetros
Tipo:
String
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
(All)
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-HostBoundVLanId
Atribui uma VLAN ao adaptador de rede virtual que foi criado para o host da rede virtual especificada.
Propriedades dos parâmetros
Tipo:
UInt16
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
Host
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
Cluster
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-JobGroup
Especifica um identificador para uma série de comandos que serão executados como um conjunto imediatamente antes da execução do comando final que inclui o mesmo identificador de grupo de trabalhos.
Propriedades dos parâmetros
Tipo:
Guid
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
(All)
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-JobVariable
Especifica que o progresso do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.
Propriedades dos parâmetros
Tipo:
String
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
(All)
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-LogicalSwitch
Especifica um objeto de comutador lógico.
Propriedades dos parâmetros
Tipo:
LogicalSwitch
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
LogicalSwitch
Position:
Named
Obrigatório:
True
Valor do pipeline:
True
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-Name
Especifica o nome de um objeto do VMM.
Propriedades dos parâmetros
Tipo:
String
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
Host
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
Cluster
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-PROTipID
Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação.
Este parâmetro permite auditar dicas PRO.
Propriedades dos parâmetros
Tipo:
Guid
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
(All)
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-RunAsynchronously
Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.
Propriedades dos parâmetros
Tipo:
SwitchParameter
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
(All)
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-VirtualNetwork
Especifica um objeto de rede virtual.
Propriedades dos parâmetros
Tipo:
VirtualNetwork
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
Host
Position:
0
Obrigatório:
True
Valor do pipeline:
True
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
LogicalSwitch
Position:
0
Obrigatório:
True
Valor do pipeline:
True
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
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.
Exemplo de formato: -VMHostNetworkAdapters $VMHostNICs
Propriedades dos parâmetros
Tipo:
HostNetworkAdapter[]
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
LogicalSwitch
Position:
Named
Obrigatório:
False
Valor do pipeline:
True
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
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.