Get-SCVMHost
Obtém objetos de host de máquina virtual do banco de dados do Virtual Machine Manager.
Sintaxe
Get-SCVMHost
[-VMMServer <ServerConnection>]
[[-ComputerName] <String>]
[-ID <Guid>]
[<CommonParameters>]
Get-SCVMHost
-VMHostGroup <HostGroup>
[[-ComputerName] <String>]
[<CommonParameters>]
Get-SCVMHost
-VMHostCluster <HostCluster>
[[-ComputerName] <String>]
[<CommonParameters>]
Description
O cmdlet Get-SCVMHost obtém um ou mais objetos de host de máquina virtual do banco de dados do Virtual Machine Manager (VMM). Os hosts de máquinas virtuais são computadores físicos gerenciados pelo VMM nos quais você pode implantar máquinas virtuais.
O VMM suporta os seguintes tipos de hosts:
- Hyper-V anfitriões
- Hosts VMware ESX
- Hosts Citrix XenServer
Para obter mais informações sobre hosts de máquina virtual no Virtual Machine Manager, digite Get-Help Add-VMHost -Detailed
.
Exemplos
Exemplo 1: Obter todos os hosts gerenciados pelo servidor VMM especificado
PS C:\> Get-SCVMHost -VMMServer "VMMServer01.Contoso.com"
Este comando obtém todos os objetos de host para todos gerenciados pelo VMMServer01 e exibe as propriedades do host para o usuário.
Exemplo 2: Obter um anfitrião por nome
PS C:\> Get-SCVMHost -ComputerName "VMHost01.Contoso.com"
Este comando obtém o objeto de host chamado VMHost01 no domínio Contoso.com e exibe as propriedades do host para o usuário.
Exemplo 3: Obter todos os hosts em um grupo de hosts específico e exibir informações sobre eles para o usuário
PS C:\> $HostGroup = Get-SCVMHostGroup -Name "HostGroup01" -VMMServer "VMMServer01.Contoso.com"
PS C:\> $HostsInHG = Get-SCVMHost -VMHostGroup $HostGroup
PS C:\> $HostsInHG | Format-Table -Property Name, VMs
O primeiro comando obtém o objeto de grupo de hosts chamado HostGroup01 do VMMServer01 e armazena o objeto na variável $HostGroup.
O segundo comando obtém todos os objetos de host no grupo de hosts armazenados no $HostGroup e armazena os objetos na variável $HostsInHG.
O último comando usa o operador de pipeline para passar todos os objetos de host armazenados em $HostsInHG para o cmdlet Format-Table, que exibe o nome de cada host e as máquinas virtuais implantadas nesse host em uma tabela.
Exemplo 4: Obter todos os hosts em um cluster de host específico e exibir informações sobre eles para o usuário
PS C:\> $Cluster = Get-SCVMHostCluster -Name "Cluster01.Contoso.com" -VMMServer "VMMServer01.Contoso.com"
PS C:\> $HostsInCluster = Get-SCVMHost -VMHostCluster $Cluster
PS C:\> $HostsInCluster | Format-Table -Property Name, VirtualizationPlatform
O primeiro comando obtém o objeto de cluster de host chamado Cluster01 do VMMServer01 e armazena o objeto na variável $Cluster.
O segundo comando obtém todos os objetos host em Cluster01 e armazena os objetos na variável $HostsInCluster.
O último comando passa todos os objetos de host armazenados em $HostsInCluster para o cmdlet Format-Table, que exibe o nome e a plataforma de virtualização de cada host no Cluster01.
Exemplo 5: Obter um host específico localizado em uma rede de perímetro por seu endereço IP
PS C:\> $VMHost = Get-VMHost -ComputerName 10.199.53.5 -VMMServer "VMMServer01.Contoso.com"
PS C:\> $VMHost | Select-Object -Property ComputerName, OperatingSystem
O primeiro comando obtém o objeto host localizado em uma rede de perímetro cujo endereço IP é 10.199.53.5 do VMMServer01 e armazena o objeto na variável $VMHost.
O segundo comando usa o operador de pipeline para passar o objeto host em $VMHost para o cmdlet Select-Object, que exibe o nome do computador e o sistema operacional do host.
Parâmetros
-ComputerName
Especifica o nome de um computador que o VMM pode identificar exclusivamente na rede. Os formatos válidos são:
- FQDN
- Endereço IPv4 ou IPv6
- Nome NetBIOS
Nota: Consulte os exemplos de um cmdlet específico para determinar como esse cmdlet especifica o nome do computador.
Tipo: | String |
Position: | 0 |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-ID
Especifica o identificador numérico como um identificador global exclusivo, ou GUID, para um objeto específico.
Tipo: | Guid |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-VMHostCluster
Especifica um objeto de cluster de host do VMM.
Tipo: | HostCluster |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-VMHostGroup
Especifica um objeto de grupo de host de máquina virtual.
Tipo: | HostGroup |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-VMMServer
Especifica um objeto de servidor VMM.
Tipo: | ServerConnection |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
Saídas
Host
Este cmdlet retorna um objeto Host.