classe Msvm_SummaryInformationBase

  • Artigo

Usado no método GetSummaryInformation na classe Msvm_VirtualSystemManagementService para recuperar rapidamente informações comuns relacionadas a um sistema virtual ou instantâneo.

A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas.

Sintaxe

[Abstract, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_SummaryInformationBase : CIM_View
{
  string   InstanceID;
  DateTime CreationTime;
  string   ElementName;
  uint16   EnabledState;
  string   OtherEnabledState;
  uint16   HealthState;
  string   Name;
  string   Notes;
  string   Version;
  uint16   NumberOfProcessors;
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  uint64   UpTime;
  uint16   EnhancedSessionModeState;
  string   VirtualSwitchNames[];
  string   VirtualSystemSubType;
  string   HostComputerSystemName;
};

Membros

A classe Msvm_SummaryInformationBase tem esses tipos de membros:

Propriedades

A classe Msvm_SummaryInformationBase tem essas propriedades.

CreationTime

Tipo de dados: DateTime

Tipo de acesso: Somente leitura

O momento em que o sistema virtual ou instantâneo foi criado.

ElementName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: Substituição ("CIM_ManagedElement.ElementName")

O nome amigável para o sistema virtual ou instantâneo.

EnabledState

Tipo de dados: uint16

Tipo de acesso: Somente leitura

O estado atual do sistema virtual ou instantâneo.

EnhancedSessionModeState

Tipo de dados: uint16

Tipo de acesso: Somente leitura

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

Permitido e disponível (2)

Não permitido (3)

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

HealthState

Tipo de dados: uint16

Tipo de acesso: Somente leitura

O estado de integridade atual do sistema virtual. Essa propriedade não é válida para instâncias de Msvm_SummaryInformation que representam um sistema virtual instantâneo.

HostComputerSystemName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

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

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> do Esquema\_<Nome> da Classe 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.

Nome

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O nome exclusivo para o sistema virtual ou instantâneo.

Observações

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

As anotações associadas ao sistema virtual ou instantâneo.

NumberOfProcessors

Tipo de dados: uint16

Tipo de acesso: Somente leitura

O número total de processadores virtuais alocados para o sistema virtual ou instantâneo.

OperationalStatus

Tipo de dados: matriz uint16

Tipo de acesso: Somente leitura

Qualificadores: ArrayType ("Indexado")

O status atual do elemento.

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 ("Outros"). Essa propriedade deve ser definida como nula quando EnabledState for qualquer valor diferente de 1.

StatusDescriptions

Tipo de dados: matriz de cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: ArrayType ("Indexado")

Cadeias de caracteres que descrevem os vários valores de matriz OperationalStatus .

Uptime

Tipo de dados: uint64

Tipo de acesso: Somente leitura

A quantidade de tempo desde que o sistema virtual foi inicializado pela última vez. Essa propriedade não é válida para instâncias de Msvm_SummaryInformation que representam um sistema 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".

VirtualSwitchNames

Tipo de dados: matriz de cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: ArrayType ("Indexado")

Cadeias de caracteres que listam os nomes amigáveis dos comutadores virtuais aos quais a VM está conectada.

VirtualSystemSubType

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O subtipo do sistema virtual.

Microsoft:Hyper-V:SubType:1 ("Microsoft:Hyper-V:SubType:1")

Microsoft:Hyper-V:SubType:2 ("Microsoft:Hyper-V:SubType:2")

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows 10, versão 1703 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows Server 2016
Namespace
 Root\virtualization\v2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

Confira também

CIM_View