Get-SCVMHost
Obtém objetos de host de máquina virtual do banco de dados do Virtual Machine Manager.
Syntax
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 VMM (Virtual Machine Manager). Hosts de máquina virtual são computadores físicos gerenciados pelo VMM nos quais você pode implantar máquinas virtuais.
O VMM dá suporte aos seguintes tipos de hosts:
- Hosts do Hyper-V
- Hosts ESX do VMware
- Hosts do 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 do VMM especificado
PS C:\> Get-SCVMHost -VMMServer "VMMServer01.Contoso.com"
Esse comando obtém todos os objetos host para todos gerenciados pelo VMMServer01 e exibe as propriedades do host para o usuário.
Exemplo 2: Obter um host por nome
PS C:\> Get-SCVMHost -ComputerName "VMHost01.Contoso.com"
Esse comando obtém o objeto 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 host 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 host chamado HostGroup01 do VMMServer01 e armazena o objeto na variável $HostGroup.
O segundo comando obtém todos os objetos host no grupo de host armazenados em $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 das 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 host chamado Cluster01 do VMMServer01 e armazena o objeto na variável $Cluster.
O segundo comando obtém todos os objetos host no 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 em sua rede. Os formatos válidos são:
- FQDN
- Endereço IPv4 ou IPv6
- Nome NetBIOS
Observação: consulte os exemplos de um cmdlet específico para determinar como esse cmdlet especifica o nome do computador.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ID
Especifica o identificador numérico como um identificador global exclusivo, ou GUID, para um objeto específico.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMHostCluster
Especifica um objeto de cluster de host do VMM.
Type: | HostCluster |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VMHostGroup
Especifica um objeto de grupo de host de máquina virtual.
Type: | HostGroup |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VMMServer
Especifica um objeto de servidor do VMM.
Type: | ServerConnection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Saídas
Host
Esse cmdlet retorna um objeto Host .