Partilhar via

Get-SCVMHostNetworkAdapter

Módulo:
VirtualMachineManager Module

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

Sintaxe

NoFilter (Predefiniçã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 Virtual Machine Manager (VMM).

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 de adaptador de rede física de 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

Este comando obtém todos os objetos de 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ísico 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 do VMHost01 e armazena o objeto na variável $HostAdapter.

O terceiro comando passa o objeto do adaptador armazenado em $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 (Trunk ou Access).

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

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

Este comando obtém objetos do adaptador de rede 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 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

-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

HostNetworkAdapter

O cmdlet retorna um objeto HostNetworkAdapter .