Get-SCVirtualNetwork

  • Referência
Módulo:
VirtualMachineManager

Obtém objetos de rede virtual configurados em um host do VMM.

Syntax

Get-SCVirtualNetwork
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [<CommonParameters>]
Get-SCVirtualNetwork
   -VMHostCluster <HostCluster>
   [[-Name] <String>]
   [<CommonParameters>]
Get-SCVirtualNetwork
   -ID <Guid>
   [[-Name] <String>]
   [<CommonParameters>]
Get-SCVirtualNetwork
   -VMHost <Host>
   [[-Name] <String>]
   [<CommonParameters>]

Description

O cmdlet Get-SCVirtualNetwork obtém um ou mais objetos de rede virtual configurados em um host gerenciado pelo VMM (Virtual Machine Manager).

Para obter informações sobre redes virtuais no VMM, digite Get-Help New-SCVirtualNetwork -Detailed.

Exemplos

Exemplo 1: Obter todas as redes virtuais no banco de dados do VMM

PS C:\> $VirtualNetworks = Get-SCVirtualNetwork 
PS C:\> $VirtualNetworks | Format-List Name,VMHost,VMHostNetworkadapters

O primeiro comando obtém todos os objetos de rede virtual em todos os hosts gerenciados pelo VMM e armazena os objetos de rede virtual em $VirtualNetworks.

O segundo comando exibe um subconjunto de informações sobre cada objeto de rede virtual em $VirtualNetworks: o nome de cada rede virtual, o host físico no qual cada rede virtual está configurada e os adaptadores de rede física configurados no host para cada rede virtual.

Exemplo 2: Obter todas as redes virtuais em um host específico

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com" 
PS C:\> Get-SCVirtualNetwork -VMHost $VMHost

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

O segundo comando obtém todos os objetos de rede virtual no VMHost01 e exibe informações sobre cada rede virtual.

Exemplo 3: obter uma rede virtual pelo nome de um host específico

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost02.Contoso.com" 
PS C:\> $VN = Get-SCVirtualNetwork -VMHost $VMHost -Name "InternalVNet01"
PS C:\> $VN

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

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

O último comando exibe informações sobre a rede virtual armazenada em $VN para o usuário.

Parâmetros

-ID

Especifica o identificador numérico como um identificador global exclusivo, ou GUID, para um objeto específico.

Type:Guid
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:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMHost

Especifica um objeto host de máquina virtual. O VMM dá suporte a hosts Hyper-V, hosts ESX VMware e hosts Citrix XenServer.

Para obter mais informações sobre cada tipo de host, consulte o cmdlet Add-SCVMHost .

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

-VMHostCluster

Especifica um objeto de cluster de host do VMM.

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

-VMMServer

Especifica um objeto de servidor do VMM.

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

Saídas

VirtualNetwork

Esse cmdlet retorna um objeto VirtualNetwork .