Get-SCVirtualNetwork
Obtém objetos de rede virtual configurados em um host VMM.
Sintaxe
NoFilter (Predefinição)
Get-SCVirtualNetwork
[[-Name] <String>]
[-VMMServer <ServerConnection>]
[<CommonParameters>]
Cluster
Get-SCVirtualNetwork
[[-Name] <String>]
-VMHostCluster <HostCluster>
[<CommonParameters>]
ByID
Get-SCVirtualNetwork
[[-Name] <String>]
-ID <Guid>
[<CommonParameters>]
FilterByVMHost
Get-SCVirtualNetwork
[[-Name] <String>]
-VMHost <Host>
[<CommonParameters>]
Description
O cmdlet Get-SCVirtualNetwork obtém um ou mais objetos de rede virtual configurados em um host gerenciado pelo Virtual Machine Manager (VMM).
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 do 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.
Propriedades dos parâmetros
| Tipo: | Guid |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
ByID
| 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
(All)
| Position: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-VMHost
Especifica um objeto de host de máquina virtual. O VMM suporta hosts Hyper-V, VMware ESX e Citrix XenServer.
Para obter mais informações sobre cada tipo de host, consulte o cmdlet Add-SCVMHost .
Propriedades dos parâmetros
| Tipo: | Host |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
FilterByVMHost
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-VMHostCluster
Especifica um objeto de cluster de host do VMM.
Propriedades dos parâmetros
| Tipo: | HostCluster |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
Cluster
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-VMMServer
Especifica um objeto de servidor VMM.
Propriedades dos parâmetros
| Tipo: | ServerConnection |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
NoFilter
| 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.
Saídas
VirtualNetwork
Este cmdlet retorna um objeto VirtualNetwork .