Compartilhar via


classe Msvm_SummaryInformation

Usado nos métodos GetSummaryInformation e GetDefinitionFileSummaryInformation na classe Msvm_VirtualSystemManagementService para recuperar rapidamente informações comuns relacionadas a uma máquina virtual ou instantâneo.

A sintaxe a seguir é o código MOF (Managed Object Format) simplificado.

Sintaxe

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_SummaryInformation : Msvm_SummaryInformationBase
{
  string                       InstanceID;
  string                       AllocatedGPU;
  boolean                      Shielded;
  CIM_ConcreteJob              AsynchronousTasks[];
  DateTime                     CreationTime;
  string                       ElementName;
  uint16                       EnabledState;
  string                       OtherEnabledState;
  string                       GuestOperatingSystem;
  uint16                       HealthState;
  uint16                       Heartbeat;
  uint64                       MemoryUsage;
  sint32                       MemoryAvailable;
  sint32                       AvailableMemoryBuffer;
  boolean                      SwapFilesInUse;
  string                       Name;
  string                       Notes;
  string                       Version;
  uint16                       NumberOfProcessors;
  uint16                       OperationalStatus[];
  uint16                       ProcessorLoad;
  uint16                       ProcessorLoadHistory[];
  CIM_VirtualSystemSettingData Snapshots[];
  string                       StatusDescriptions[];
  uint8                        ThumbnailImage[];
  uint16                       ThumbnailImageHeight;
  uint16                       ThumbnailImageWidth;
  uint64                       UpTime;
  uint16                       ReplicationState;
  uint16                       ReplicationStateEx[];
  uint16                       ReplicationHealth;
  uint16                       ReplicationHealthEx[];
  uint16                       ReplicationMode;
  CIM_ComputerSystem       REF TestReplicaSystem;
  uint16                       ApplicationHealth;
  uint16                       IntegrationServicesVersionState;
  boolean                      MemorySpansPhysicalNumaNodes;
  string                       ReplicationProviderId[];
  uint16                       EnhancedSessionModeState;
  string                       VirtualSwitchNames[];
  string                       VirtualSystemSubType;
  string                       HostComputerSystemName;
};

Membros

A classe Msvm_SummaryInformation tem estes tipos de membros:

Propriedades

A classe Msvm_SummaryInformation tem essas propriedades.

AllocatedGPU

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O identificador da GPU (unidade de processamento de elementos gráficos físicos) alocada para essa máquina virtual. Essa propriedade só se aplica a máquinas virtuais que usam RemoteFX.

ApplicationHealth

Tipo de dados: uint16

Tipo de acesso: Somente leitura

O status de integridade do aplicativo atual para a máquina virtual. Essa propriedade não é válida para instâncias de Msvm_SummaryInformation que representam uma máquina virtual instantâneo.

OK (2)

Application Critical (32782)

Desabilitado (32896)

AssíncronosTasks

Tipo de dados: CIM_ConcreteJob matriz

Tipo de acesso: Somente leitura

Qualificadores: ArrayType ("Indexado")

Uma matriz de instâncias de Msvm_ConcreteJob que representam quaisquer operações assíncronas relacionadas à máquina virtual que está sendo executada no momento. Essa propriedade não é válida para instâncias de Msvm_SummaryInformation que representam uma máquina virtual instantâneo.

AvailableMemoryBuffer

Tipo de dados: sint32

Tipo de acesso: Somente leitura

O percentual de buffer de memória disponível para a máquina virtual. Quando a memória dinâmica está habilitada para uma máquina virtual, essa propriedade representa a proporção do buffer de memória disponível para o buffer de memória ideal para a máquina virtual. O tamanho ideal do buffer de memória é configurado usando a propriedade TargetMemoryBuffer da classe Msvm_MemorySettingData .

Essa propriedade não é válida para instâncias da classe Msvm_SummaryInformation que representam máquinas virtuais para as quais a memória dinâmica não está habilitada.

Essa propriedade não é válida para instâncias da classe Msvm_SummaryInformation que representam uma máquina virtual instantâneo.

CreationTime

Tipo de dados: DateTime

Tipo de acesso: Somente leitura

O momento em que a máquina virtual ou instantâneo foi criada.

ElementName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O nome de exibição para a máquina virtual ou instantâneo.

EnabledState

Tipo de dados: uint16

Tipo de acesso: Somente leitura

O estado atual da máquina virtual ou instantâneo. Consulte a propriedade EnabledState da classe Msvm_ComputerSystem para obter valores possíveis.

EnhancedSessionModeState

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Indica se as conexões de modo aprimorado são permitidas pelo host e, se permitido, se estão disponíveis para a máquina virtual.

Windows 8.1: esse valor não tem suporte até Windows 8.1 e Windows Server 2012 R2.

Permitido e disponível (2)

Não permitido (3)

Permitido, mas não disponível (6 )

GuestOperatingSystem

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O nome do sistema operacional convidado, se disponível. Se essas informações não estiverem disponíveis, o valor dessa propriedade será Null. Essa propriedade não é válida para instâncias de Msvm_SummaryInformation que representam uma máquina virtual instantâneo.

HealthState

Tipo de dados: uint16

Tipo de acesso: Somente leitura

O estado de integridade atual da máquina virtual. Essa propriedade não é válida para instâncias de Msvm_SummaryInformation que representam uma máquina virtual instantâneo.

Pulsação

Tipo de dados: uint16

Tipo de acesso: Somente leitura

A pulsação atual status para a máquina virtual. Para obter mais informações, consulte a documentação da propriedade StatusDescriptions da classe Msvm_HeartbeatComponent . Essa propriedade não é válida para instâncias de Msvm_SummaryInformation que representam uma máquina virtual instantâneo.

OK (2)

Erro (6)

Sem Contato (12)

Comunicação Perdida (13)

HostComputerSystemName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O nome do computador que hospeda essa máquina virtual.

Observação

Adicionado em Windows 10.

InstanceID

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: Substituição ("CIM_ManagedElement.InstanceID"), Chave

InstanceID é uma propriedade opcional que pode ser usada para identificar de forma opaca e exclusivamente uma instância dessa classe dentro do escopo do Namespace de instanciação. Várias subclasses dessa classe podem substituir essa propriedade para torná-la necessária ou uma chave. Essas subclasses também podem modificar os algoritmos preferenciais para garantir a exclusividade definida abaixo.

Para garantir a exclusividade no NameSpace, o valor de InstanceID deve ser construído usando o seguinte algoritmo "preferencial":

<OrgID>:<LocalID>

Em <que OrgID> e <LocalID> são separados por dois-pontos (:) e em <que OrgID> deve incluir um nome com direitos autorais, marca registrada ou de outra forma exclusivo pertencente à entidade de negócios que está criando ou definindo o InstanceID ou que é uma ID registrada atribuída à entidade de negócios por uma autoridade global reconhecida. (Esse requisito é semelhante ao < Estrutura nome><> da classe de esquema de nomes de classe de esquema.) Além disso, para garantir a exclusividade, <OrgID> não deve conter dois-pontos (:). Ao usar esse algoritmo, os primeiros dois-pontos a aparecer em InstanceID devem aparecer entre <OrgID> e <LocalID>.

<LocalID> é escolhido pela entidade de negócios e não deve ser reutilizado para identificar diferentes elementos subjacentes (do mundo real). Se não for nulo e o algoritmo "preferencial" acima não for usado, a entidade de definição deverá garantir que o InstanceID resultante não seja reutilizado em nenhuma InstanceIDs produzida por este ou outros provedores para o NameSpace desta instância.

Se não estiver definido como nulo para instâncias definidas por DMTF, o algoritmo "preferencial" deverá ser usado com o <OrgID> definido como CIM.

Observação

Adicionado em Windows 10.

IntegrationServicesVersionState

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Indica se os serviços de integração instalados na máquina virtual estão atualizados.

Desconhecido (0)

UpToDate (1)

Incompatibilidade (2)

MemoryAvailable

Tipo de dados: sint32

Tipo de acesso: Somente leitura

O percentual da memória atual disponível para a máquina virtual. Quando a memória dinâmica está habilitada para uma máquina virtual, essa propriedade representa a taxa de memória disponível da máquina virtual para a memória física total atribuída à máquina virtual. Quando uma máquina virtual não tiver memória disponível, essa propriedade será negativa e conterá a taxa de memória necessária para a máquina virtual para a memória física total atribuída à máquina virtual.

Essa propriedade não é válida para instâncias da classe Msvm_SummaryInformation que representam máquinas virtuais para as quais a memória dinâmica não está habilitada.

Essa propriedade não é válida para instâncias da classe Msvm_SummaryInformation que representam uma máquina virtual instantâneo.

MemorySpansPhysicalNumaNodes

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Indica se a memória de um ou mais dos nós NUMA (acesso virtual nãouniforma à memória) da máquina virtual abrange vários nós NUMA físicos do sistema de computador de hospedagem. Contém True se a memória abranger vários nós NUMA físicos ou False caso contrário.

MemoryUsage

Tipo de dados: uint64

Tipo de acesso: Somente leitura

O uso de memória atual, em megabytes, da máquina virtual. Essa propriedade não é válida para instâncias de Msvm_SummaryInformation que representam uma máquina virtual instantâneo.

Nome

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O nome exclusivo para a máquina virtual ou instantâneo.

Observações

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

As anotações associadas à máquina virtual ou instantâneo.

NumberOfProcessors

Tipo de dados: uint16

Tipo de acesso: Somente leitura

O número total de processadores virtuais alocados para a máquina virtual ou instantâneo.

OperationalStatus

Tipo de dados: matriz uint16

Tipo de acesso: Somente leitura

Qualificadores: ArrayType ("Indexado")

Os status operacionais atuais da máquina virtual. Consulte a propriedade OperationalStatus da classe Msvm_ComputerSystem para obter valores possíveis.

OtherEnabledState

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Uma cadeia de caracteres que descreve o estado habilitado ou desabilitado do elemento quando a propriedade EnabledState é definida como 1. Essa propriedade será definida como Null quando EnabledState for qualquer valor diferente de 1.

ProcessorLoad

Tipo de dados: uint16

Tipo de acesso: Somente leitura

O uso atual do processador da máquina virtual, em porcentagem. Essa propriedade não é válida para instâncias de Msvm_SummaryInformation que representam uma máquina virtual instantâneo.

ProcessorLoadHistory

Tipo de dados: matriz uint16

Tipo de acesso: Somente leitura

Qualificadores: ArrayType ("Indexado")

Uma matriz dos 100 exemplos anteriores do uso do processador, em porcentagem, para a máquina virtual. Essa propriedade não é válida para instâncias de Msvm_SummaryInformation que representam uma máquina virtual instantâneo.

Replicationhealth

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: preterido ("Msvm_SummaryInformation. ReplicationHealthEx")

A integridade da replicação para a máquina virtual. Consulte a propriedade ReplicationHealth da classe Msvm_ComputerSystem para obter valores possíveis.

Observação

Essa propriedade foi preterida começando com Windows 8.1; em vez disso, use ReplicationHealthEx.

Não aplicável (0)

Ok (1)

Aviso (2)

Crítico (3)

ReplicationHealthEx

Tipo de dados: matriz uint16

Tipo de acesso: Somente leitura

Qualificadores: ArrayType ("Indexado")

A matriz de valores de integridade de replicação para as várias relações de replicação da máquina virtual. Consulte a propriedade ReplicationHealth da classe Msvm_ReplicationRelationship para obter valores possíveis.

Não aplicável (0)

Ok (1)

Aviso (2)

Crítico (3)

ReplicationMode

Tipo de dados: uint16

Tipo de acesso: Somente leitura

O tipo de replicação para a máquina virtual. Consulte a propriedade ReplicationMode da classe Msvm_ComputerSystem para obter valores possíveis.

Nenhum (0)

Primário (1)

Réplica (2)

Réplica de teste (3)

Réplica Estendida (4)

ReplicationProviderId

Tipo de dados: matriz de cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: ArrayType ("Indexado")

Para a máquina virtual de réplica primária ou estendida, essa é a ID do provedor de replicação primária. Para uma máquina virtual réplica e se a replicação estendida estiver habilitada, essa será a ID do provedor para relacionamento estendido.

Windows 8.1: esse valor não tem suporte até Windows 8.1 e Windows Server 2012 R2.

ReplicationState

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: preterido ("Msvm_SummaryInformation. ReplicationStateEx")

O estado de replicação da máquina virtual. Consulte a propriedade ReplicationState da classe Msvm_ComputerSystem para obter valores possíveis.

Observação

Essa propriedade foi preterida começando com Windows 8.1; em vez disso, use ReplicationStateEx.

Desabilitado (0)

Pronto para replicação (1)

Aguardando para concluir a replicação inicial (2)

Replicação (3)

Replicação sincronizada concluída (4)

Recuperado (5)

Confirmado (6)

Suspenso (7)

Crítico (8)

Aguardando para iniciar a ressincronização (9)

Ressincronização (10)

Ressincronização suspensa (11)

Failover em andamento (12)

ReplicationStateEx

Tipo de dados: matriz uint16

Tipo de acesso: Somente leitura

Qualificadores: ArrayType ("Indexed")

A matriz de valores de estado de replicação para as várias relações de replicação da máquina virtual. Consulte a propriedade ReplicationState da classe Msvm_ReplicationRelationship para obter valores possíveis.

Desabilitado (0)

Pronto para replicação (1)

Aguardando para concluir a replicação inicial (2)

Replicação (3)

Replicação sincronizada concluída (4)

Recuperado (5)

Confirmado (6)

Suspenso (7)

Crítico (8)

Aguardando para iniciar a ressincronização (9)

Ressincronização (10)

Ressincronização suspensa (11)

Failover em andamento (12)

Failback em andamento (13)

Failback concluído (14)

Atualização de disco em andamento (15)

Observação

Adicionado em Windows 10, versão 1703 e Windows Server 2016.

Atualização de disco crítica (16)

Observação

Adicionado em Windows 10, versão 1703 e Windows Server 2016.

Desconhecido (17)

Observação

Adicionado em Windows 10, versão 1703 e Windows Server 2016.

Redefinir a replicação em andamento (18)

Observação

Adicionado em Windows 10, versão 1703 e Windows Server 2016.

Preparado para replicação de sincronização (19)

Observação

Adicionado em Windows 10, versão 1703 e Windows Server 2016.

Preparado para replicação reversa de grupo (20)

Observação

Adicionado em Windows 10, versão 1703 e Windows Server 2016.

Firedrill em andamento (21)

Observação

Adicionado em Windows 10, versão 1703 e Windows Server 2016.

Blindado

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Indica se a blindagem está configurada ou não para a máquina virtual.

Observação

Adicionado em Windows 10, versão 1703 e Windows Server 2016.

Instantâneos

Tipo de dados: CIM_VirtualSystemSettingData matriz

Tipo de acesso: Somente leitura

Qualificadores: ArrayType ("Indexed")

Uma matriz de Msvm_VirtualSystemSettingData instâncias que representam os instantâneos da máquina virtual. Essa propriedade não é válida para instâncias de Msvm_SummaryInformation que representam uma máquina virtual instantâneo.

StatusDescriptions

Tipo de dados: matriz de cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: ArrayType ("Indexed")

Cadeias de caracteres que descrevem os valores de matriz OperationalStatus correspondentes. Isso corresponde à propriedade StatusDescriptions da classe Msvm_ComputerSystem .

SwapFilesInUse

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Indica se a paginação de segundo nível está ativa. Contém True se a paginação de segundo nível estiver ativa ou False caso contrário.

TestReplicaSystem

Tipo de dados: CIM_ComputerSystem

Tipo de acesso: Somente leitura

Referência a uma instância de CIM_ComputerSystem que representa o teste réplica máquina virtual para a máquina virtual. Essa propriedade não é válida para instâncias de Msvm_SummaryInformation que representam uma máquina virtual instantâneo.

ThumbnailImage

Tipo de dados: matriz uint8

Tipo de acesso: Somente leitura

Qualificadores: OctetString, ArrayType ("Indexed"), ModelCorrespondence ("Msvm_SummaryInformation. ThumbnailImageWidth", "Msvm_SummaryInformation. ThumbnailImageHeight")

Uma matriz que contém uma imagem pequena do tamanho de miniatura da área de trabalho para a máquina virtual ou instantâneo no formato RGB565.

ThumbnailImageHeight

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: ModelCorrespondence ("Msvm_SummaryInformation. ThumbnailImage")

A altura em pixels da imagem na propriedade ThumbnailImage.

Observação

Adicionado em Windows 10.

ThumbnailImageWidth

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: ModelCorrespondence ("Msvm_SummaryInformation. ThumbnailImage")

A largura em pixels da imagem na propriedade ThumbnailImage.

Observação

Adicionado em Windows 10.

Uptime

Tipo de dados: uint64

Tipo de acesso: Somente leitura

A quantidade de tempo desde que a máquina virtual foi inicializada pela última vez. Essa propriedade não é válida para instâncias de Msvm_SummaryInformation que representam uma máquina virtual instantâneo.

Versão

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

A versão do sistema virtual em um formato de "major.minor", por exemplo, "2.0".

Observação

Adicionado em Windows 10.

VirtualSwitchNames

Tipo de dados: matriz de cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: ArrayType ("Indexado")

Cadeias de caracteres que especificam os nomes amigáveis dos comutadores virtuais aos quais a máquina virtual está conectada.

Windows 8.1: esse valor não tem suporte até Windows 8.1 e Windows Server 2012 R2.

VirtualSystemSubType

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O subtipo do sistema virtual.

Windows 8.1: esse valor não tem suporte até Windows 8.1 e Windows Server 2012 R2.

Microsoft:Hyper-V:SubType:1 ()

Microsoft:Hyper-V:SubType:2 ()

Comentários

O acesso à classe Msvm_SummaryInformation pode ser restrito pela Filtragem UAC. Para obter mais informações, consulte Controle de Conta de Usuário e WMI.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2012 [somente aplicativos da área de trabalho]
Namespace
Root\Virtualization\V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

Confira também

Msvm_SummaryInformationBase

Classes do sistema virtual