Partilhar via


Get-SCVirtualNetwork

Obtém objetos de rede virtuais configurados num hospedeiro 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 virtuais configurados num hospedeiro gerido pelo Virtual Machine Manager (VMM).

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

Exemplos

Exemplo 1: Obtenha todas as redes virtuais na base de dados VMM

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

O primeiro comando obtém todos os objetos de rede virtuais em todos os anfitriões geridos por VMM e armazena os objetos de rede virtuais em $VirtualNetworks.

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

Exemplo 2: Obter todas as redes virtuais num anfitrião específico

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

O primeiro comando recebe o objeto anfitrião chamado VMHost01 e armazena o objeto na variável $VMHost.

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

Exemplo 3: Obtenha uma rede virtual pelo nome de um anfitrião 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 recebe o objeto anfitrião 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 armazenadas em $VN ao utilizador.

Parâmetros

-ID

Especifica o identificador numérico como um identificador globalmente único, 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 hospedeiro de máquina virtual. A VMM suporta anfitriões Hiper-V, anfitriões VMware ESX e anfitriões Citrix XenServer.

Para obter mais informações sobre cada tipo de hospedeiro, 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 hospedeiro VMM.

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

-VMMServer

Especifica um objeto de servidor VMM.

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

Saídas

VirtualNetwork

Este cmdlet devolve um objeto VirtualNetwork .