Compartilhar via

Get-SCVMHostNetworkAdapter

Módulo:
VirtualMachineManager Module

Obtém objetos de adaptador de rede física em um host do VMM.

Sintaxe

NoFilter (Padrão) 

Get-SCVMHostNetworkAdapter
    [[-Name] <String>]
    [-VMMServer <ServerConnection>]
    [<CommonParameters>]

ByID 

Get-SCVMHostNetworkAdapter
    [[-Name] <String>]
    -ID <Guid>
    [<CommonParameters>]

FilterByVMHost 

Get-SCVMHostNetworkAdapter
    [[-Name] <String>]
    -VMHost <Host>
    [<CommonParameters>]

Description

O cmdlet Get-SCVMHostNetworkAdapter obtém um ou mais objetos de adaptador de rede física em um host gerenciado pelo VMM (Virtual Machine Manager).

Exemplos

Exemplo 1: Obter todos os adaptadores de rede física no host especificado

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com"
PS C:\> $HostAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost
PS C:\> $HostAdapter | select -property Name, ConnectionState

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 do adaptador de rede física do VMHost01 e, em seguida, armazena os objetos na variável $HostAdapter.

O terceiro comando exibe o nome e o estado da conexão para cada adaptador.

Exemplo 2: Obter todos os adaptadores de rede física no banco de dados do VMM

PS C:\> Get-SCVMHostNetworkAdapter | Format-List Name, MacAddress, VMHost, MaxBandwidth

Esse comando obtém todos os objetos do adaptador de rede física em todos os hosts gerenciados pelo servidor VMM e exibe o nome de cada adaptador, seu endereço MAC, seu nome de host e sua largura de banda máxima.

Exemplo 3: Obter um adaptador de rede física pelo nome de um host específico

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com"
PS C:\> $HostAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter01"
PS C:\> $HostAdapter | Format-List -property Name,VLANEnabled,VLANMode

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 do adaptador de rede chamado HostAdapter01 de VMHost01 e armazena o objeto na variável $HostAdapter.

O terceiro comando passa o objeto adaptador armazenado no $HostAdapter para o cmdlet Format-List, que exibe o nome, se a LAN virtual está habilitada ou não e o valor atual para o modo VLAN (Tronco ou Acesso).

Exemplo 4: obter cada adaptador de rede de host que inclui "Broadcom" em seu nome

PS C:\> Get-SCVMHostNetworkAdapter -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -match "Broadcom" } | Format-List -Property Name,IPAddresses

Esse comando obtém objetos de adaptador de rede de host do VMMServer01 que incluem a cadeia de caracteres "Broadcom" em seu nome. e, em seguida, exibe o nome e os endereços IP de cada adaptador.

Parâmetros

-ID

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

Propriedades do parâmetro

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

Conjuntos de parâmetros

ByID
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

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

-VMHost

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

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

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-VMMServer

Especifica um objeto de servidor do VMM.

Propriedades do parâmetro

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

Conjuntos de parâmetros

NoFilter
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

HostNetworkAdapter

O cmdlet retorna um objeto HostNetworkAdapter .