Partilhar via

Get-SCVirtualMachine

  • Referência
Módulo:
VirtualMachineManager

Obtém objetos de máquina virtual.

Sintaxe

Get-SCVirtualMachine
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [-All]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualMachine
   -VMHost <Host>
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualMachine
   [-VMMServer <ServerConnection>]
   -Cloud <Cloud>
   [[-Name] <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualMachine
   [-VMMServer <ServerConnection>]
   -Service <Service>
   [[-Name] <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualMachine
   [-VMMServer <ServerConnection>]
   -ComputerTier <ComputerTier>
   [[-Name] <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualMachine
   [-VMMServer <ServerConnection>]
   -StorageQoSPolicy <StorageQoSPolicy>
   [[-Name] <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualMachine
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [-ID <Guid>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

O cmdlet Get-SCVirtualMachine obtém um ou mais objetos de máquina virtual do banco de dados do Virtual Machine Manager (VMM). Este cmdlet obtém máquinas virtuais que são implantadas em um host de máquina virtual ou armazenadas na biblioteca do VMM.

Exemplos

Exemplo 1: Obter todas as máquinas virtuais e exibir informações sobre cada uma delas

PS C:\> Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com"

Este comando obtém todos os objetos de máquina virtual no VMMServer01 e exibe informações sobre esses objetos de máquina virtual.

Exemplo 2: Obter todas as máquinas virtuais e exibir informações sobre propriedades específicas

PS C:\> Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | Format-List -Property Name, Owner, Description, HostName, OperatingSystem, CPUCount, Memory

Este comando obtém todos os objetos de máquina virtual no VMMServer01 e exibe os valores das propriedades especificadas.

Exemplo 3: Obter uma máquina virtual pelo nome armazenada em um servidor de biblioteca especificado

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> Get-SCVirtualMachine | Where-Object { $_.Name -Eq "VM02" -And $_.LibraryServer -Eq "LibraryServer01" } | Select-Object Name,LibraryServer,Status

O primeiro comando se conecta ao VMMServer01.

O segundo comando obtém o objeto de máquina virtual chamado VM02 armazenado em LibraryServer01 e, em seguida, exibe o nome da máquina virtual, o nome do servidor de biblioteca e o status da máquina virtual.

Exemplo 4: Obter todas as máquinas virtuais no host especificado

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> Get-SCVirtualMachine -VMHost "VMHost01.Contoso.com"

O primeiro comando se conecta ao VMMServer01.

O segundo comando obtém todos os objetos de máquina virtual implantados no VMHost01 e exibe informações sobre essas máquinas virtuais.

Parâmetros

-All

Indica que esse cmdlet obtém todos os objetos subordinados independentes do objeto pai. Por exemplo, o comando Get-SCVirtualDiskDrive -All obtém todos os objetos de unidade de disco virtual, independentemente do objeto de máquina virtual ou objeto de modelo ao qual cada objeto de unidade de disco virtual está associado.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Cloud

Especifica um objeto de nuvem privada.

Tipo:Cloud
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ComputerTier

Especifica um objeto de camada de computador.

Tipo:ComputerTier
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ID

Especifica a ID exclusiva de um objeto.

Tipo:Guid
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

Especifica o nome de um objeto do VMM.

Tipo:String
Position:0
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-OnBehalfOfUser

Especifica um nome de usuário. Este cmdlet opera em nome do usuário especificado por esse parâmetro.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-OnBehalfOfUserRole

Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole. Este cmdlet opera em nome da função de usuário especificada por esse parâmetro.

Tipo:UserRole
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Service

Especifica um objeto de serviço do VMM.

Tipo:Service
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-StorageQoSPolicy

Especifica a política de Qualidade de Serviço (QoS) para as máquinas virtuais obtidas por esse cmdlet.

Tipo:StorageQoSPolicy
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais: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.

Tipo:Host
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

VirtualMachine

Este cmdlet retorna um objeto VirtualMachine.