classe Msvm_SummaryInformation

Articolo
06/12/2023

Usato nei metodi GetSummaryInformation e GetDefinitionFileSummaryInformation nella classe Msvm_VirtualSystemManagementService per recuperare rapidamente informazioni comuni correlate a una macchina virtuale o a uno snapshot.

La sintassi seguente è il codice MOF (Managed Object Format) semplificato.

Sintassi

[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;
};

Members

La classe Msvm_SummaryInformation include questi tipi di membri:

Proprietà

Proprietà

La classe Msvm_SummaryInformation dispone di queste proprietà.

AllocateGPU

Tipo di dati: stringa
Tipo di accesso: sola lettura

Identificatore dell'unità di elaborazione grafica fisica (GPU) allocata a questa macchina virtuale. Questa proprietà si applica solo alle macchine virtuali che usano RemoteFX.

ApplicationHealth

Tipo di dati: uint16
Tipo di accesso: sola lettura

Stato di integrità dell'applicazione corrente per la macchina virtuale. Questa proprietà non è valida per le istanze di Msvm_SummaryInformation che rappresentano uno snapshot di macchina virtuale.

OK (2)

Application Critical (32782)

Disabilitato (32896)

AsincroneTasks

Tipo di dati: matrice di CIM_ConcreteJob
Tipo di accesso: sola lettura
Qualificatori: ArrayType ("Indicizzato")

Matrice di istanze di Msvm_ConcreteJob che rappresentano operazioni asincrone correlate alla macchina virtuale attualmente in esecuzione. Questa proprietà non è valida per le istanze di Msvm_SummaryInformation che rappresentano uno snapshot di macchina virtuale.

AvailableMemoryBuffer

Tipo di dati: sint32
Tipo di accesso: sola lettura

Percentuale del buffer di memoria disponibile per la macchina virtuale. Quando la memoria dinamica è abilitata per una macchina virtuale, questa proprietà rappresenta il rapporto tra il buffer di memoria disponibile e il buffer di memoria ideale per la macchina virtuale. Le dimensioni ideali del buffer di memoria sono configurate usando la proprietà TargetMemoryBuffer della classe Msvm_MemorySettingData .

Questa proprietà non è valida per le istanze della classe Msvm_SummaryInformation che rappresentano macchine virtuali per cui la memoria dinamica non è abilitata.

Questa proprietà non è valida per le istanze della classe Msvm_SummaryInformation che rappresentano uno snapshot della macchina virtuale.

CreationTime

Tipo di dati: DateTime
Tipo di accesso: sola lettura

Ora in cui è stata creata la macchina virtuale o lo snapshot.

ElementName

Tipo di dati: stringa
Tipo di accesso: sola lettura

Nome visualizzato per la macchina virtuale o lo snapshot.

EnabledState

Tipo di dati: uint16
Tipo di accesso: sola lettura

Stato corrente della macchina virtuale o dello snapshot. Per i valori possibili, vedere la proprietà EnabledState della classe Msvm_ComputerSystem .

EnhancedSessionModeState

Tipo di dati: uint16
Tipo di accesso: sola lettura

Indica se le connessioni in modalità avanzata sono consentite dall'host e, se consentite, se sono disponibili per la macchina virtuale.

Windows 8.1: questo valore non è supportato fino a Windows 8.1 e Windows Server 2012 R2.

Consentito e disponibile (2)

Non consentito (3)

Consentito ma non disponibile (6 )

GuestOperatingSystem

Tipo di dati: stringa
Tipo di accesso: sola lettura

Nome del sistema operativo guest, se disponibile. Se queste informazioni non sono disponibili, il valore di questa proprietà è Null. Questa proprietà non è valida per le istanze di Msvm_SummaryInformation che rappresentano uno snapshot di macchina virtuale.

HealthState

Tipo di dati: uint16
Tipo di accesso: sola lettura

Stato di integrità corrente per la macchina virtuale. Questa proprietà non è valida per le istanze di Msvm_SummaryInformation che rappresentano uno snapshot di macchina virtuale.

Heartbeat

Tipo di dati: uint16
Tipo di accesso: sola lettura

Stato dell'heartbeat corrente per la macchina virtuale. Per altre informazioni, vedere la documentazione per la proprietà StatusDescriptions della classe Msvm_HeartbeatComponent . Questa proprietà non è valida per le istanze di Msvm_SummaryInformation che rappresentano uno snapshot di macchina virtuale.

OK (2)
Errore (6)
Nessun contatto (12)
Comunicazione persa (13)

HostComputerSystemName

Tipo di dati: stringa
Tipo di accesso: sola lettura

Nome del computer che ospita questa macchina virtuale.

Nota

Aggiunta in Windows 10.

InstanceID

Tipo di dati: stringa
Tipo di accesso: sola lettura
Qualificatori: Override ("CIM_ManagedElement.InstanceID"), Chiave

InstanceID è una proprietà facoltativa che può essere usata per identificare in modo opaco e univoco un'istanza di questa classe nell'ambito dell'istanza dello spazio dei nomi. Varie sottoclassi di questa classe possono eseguire l'override di questa proprietà per renderla necessaria o una chiave. Tali sottoclassi possono anche modificare gli algoritmi preferiti per garantire l'univocità definita di seguito.

Per garantire l'univocità all'interno di NameSpace, il valore di InstanceID deve essere costruito usando l'algoritmo "preferito" seguente:

<OrgID:<LocalID>>

Dove <OrgID e <LocalID>> sono separati da due punti (:) e dove <OrgID> deve includere un nome protetto da copyright, marchio o altro nome univoco di proprietà dell'entità aziendale che sta creando o definendo l'IstanzaID o che è un ID registrato assegnato all'entità aziendale da un'autorità globale riconosciuta. (Questo requisito è simile al < Struttura Nome><> classe schema dei nomi di classe Schema. Inoltre, per garantire l'univocità, <OrgID> non deve contenere due punti (:). Quando si usa questo algoritmo, i primi due punti da visualizzare in InstanceID devono essere visualizzati tra <OrgID e <LocalID>>.

<LocalID> viene scelto dall'entità aziendale e non deve essere riutilizzato per identificare elementi sottostanti diversi (reali). Se non null e l'algoritmo "preferito" precedente non viene usato, l'entità di definizione deve garantire che l'istanza risultante non venga riutilizzata in tutti gli ID istanze generati da questo o altri provider per NameSpace di questa istanza.

Se non è impostato su Null per le istanze definite da DMTF, l'algoritmo "preferito" deve essere usato con orgID <> impostato su CIM.

Nota

Aggiunta in Windows 10.

IntegrationServicesVersionState

Tipo di dati: uint16
Tipo di accesso: sola lettura

Indica se i servizi di integrazione installati nella macchina virtuale sono aggiornati.

Sconosciuto (0)

UpToDate (1)

Mancata corrispondenza (2)

MemoryAvailable

Tipo di dati: sint32
Tipo di accesso: sola lettura

Percentuale della memoria corrente disponibile per la macchina virtuale. Quando la memoria dinamica è abilitata per una macchina virtuale, questa proprietà rappresenta il rapporto tra memoria disponibile della macchina virtuale e la memoria fisica totale assegnata alla macchina virtuale. Quando una macchina virtuale non ha memoria disponibile, questa proprietà sarà negativa e conterrà il rapporto di memoria necessaria per la macchina virtuale al totale della memoria fisica assegnata alla macchina virtuale.

Questa proprietà non è valida per le istanze della classe Msvm_SummaryInformation che rappresentano macchine virtuali per cui la memoria dinamica non è abilitata.

Questa proprietà non è valida per le istanze della classe Msvm_SummaryInformation che rappresentano uno snapshot della macchina virtuale.

MemorySpansPhysicalNumaNodes

Tipo di dati: booleano
Tipo di accesso: sola lettura

Indica se la memoria di uno o più nodi di accesso alla memoria nonuniforme virtuale della macchina virtuale si estende su più nodi NUMA fisici del sistema computer di hosting. Contiene True se la memoria si estende su più nodi NUMA fisici o False in caso contrario.

MemoryUsage

Tipo di dati: uint64
Tipo di accesso: sola lettura

Utilizzo della memoria corrente, in megabyte, della macchina virtuale. Questa proprietà non è valida per le istanze di Msvm_SummaryInformation che rappresentano uno snapshot di macchina virtuale.

Nome

Tipo di dati: stringa
Tipo di accesso: sola lettura

Nome univoco per la macchina virtuale o lo snapshot.

Note

Tipo di dati: stringa
Tipo di accesso: sola lettura

Note associate alla macchina virtuale o allo snapshot.

NumberOfProcessors

Tipo di dati: uint16
Tipo di accesso: sola lettura

Numero totale di processori virtuali allocati alla macchina virtuale o allo snapshot.

OperationalStatus

Tipo di dati: matrice uint16
Tipo di accesso: sola lettura
Qualificatori: ArrayType ("Indicizzato")

Stato operativo corrente della macchina virtuale. Per i valori possibili, vedere la proprietà OperationalStatus della classe Msvm_ComputerSystem .

OtherEnabledState

Tipo di dati: stringa
Tipo di accesso: sola lettura

Stringa che descrive lo stato abilitato o disabilitato dell'elemento quando la proprietà EnabledState è impostata su 1. Questa proprietà verrà impostata su Null quando EnabledState è qualsiasi valore diverso da 1.

ProcessorLoad

Tipo di dati: uint16
Tipo di accesso: sola lettura

Utilizzo corrente del processore della macchina virtuale, in percentuale. Questa proprietà non è valida per le istanze di Msvm_SummaryInformation che rappresentano uno snapshot di macchina virtuale.

ProcessorLoadHistory

Tipo di dati: matrice uint16
Tipo di accesso: sola lettura
Qualificatori: ArrayType ("Indicizzato")

Matrice dei precedenti 100 esempi dell'utilizzo del processore, in percentuale, per la macchina virtuale. Questa proprietà non è valida per le istanze di Msvm_SummaryInformation che rappresentano uno snapshot di macchina virtuale.

Replicationhealth

Tipo di dati: uint16
Tipo di accesso: sola lettura
Qualificatori: deprecato ("Msvm_SummaryInformation. ReplicationHealthEx")

Integrità della replica per la macchina virtuale. Per i valori possibili, vedere la proprietà ReplicationHealth della classe Msvm_ComputerSystem .

Nota

Questa proprietà è deprecata a partire da Windows 8.1; invece, usare ReplicationHealthEx.

Non applicabile (0)

Ok (1)

Avviso (2)

Critico (3)

ReplicationHealthEx

Tipo di dati: matrice uint16
Tipo di accesso: sola lettura
Qualificatori: ArrayType ("Indicizzato")

Matrice di valori di integrità della replica per le varie relazioni di replica della macchina virtuale. Per i valori possibili, vedere la proprietà ReplicationHealth della classe Msvm_ReplicationRelationship .

Non applicabile (0)

Ok (1)

Avviso (2)

Critico (3)

ReplicationMode

Tipo di dati: uint16
Tipo di accesso: sola lettura

Tipo di replica per la macchina virtuale. Per i valori possibili, vedere la proprietà ReplicationMode della classe Msvm_ComputerSystem .

Nessuno (0)

Primario (1)

Replica (2)

Replica di test (3)

Replica estesa (4)

ReplicationProviderId

Tipo di dati: matrice di stringhe
Tipo di accesso: sola lettura
Qualificatori: ArrayType ("Indicizzato")

Per la macchina virtuale di replica primaria o estesa, si tratta dell'ID del provider di replica primario. Per una macchina virtuale di replica e se la replica estesa è abilitata, si tratta dell'ID provider per la relazione estesa.

Windows 8.1: questo valore non è supportato fino a Windows 8.1 e Windows Server 2012 R2.

ReplicationState

Tipo di dati: uint16
Tipo di accesso: sola lettura
Qualificatori: deprecato ("Msvm_SummaryInformation. ReplicationStateEx")

Stato di replica per la macchina virtuale. Per i valori possibili, vedere la proprietà ReplicationState della classe Msvm_ComputerSystem .

Nota

Questa proprietà è deprecata a partire da Windows 8.1; usare invece ReplicationStateEx.

Disabilitato (0)

Pronto per la replica (1)

Attesa del completamento della replica iniziale (2)

Replica ( 3)

Replica sincronizzata completata (4)

Recuperato (5)

Commit (6)

Sospeso (7)

Critico (8)

In attesa di avviare la risynchronization (9)

Risincronizzazione (10)

Risincronizzazione sospesa (11)

Failover in corso (12)

ReplicationStateEx

Tipo di dati: matrice uint16
Tipo di accesso: sola lettura
Qualificatori: ArrayType ("Indicizzato")

Matrice di valori dello stato di replica per le varie relazioni di replica della macchina virtuale. Per i valori possibili, vedere la proprietà ReplicationState della classe Msvm_ReplicationRelationship .

Disabilitato (0)

Pronto per la replica (1)

Attesa del completamento della replica iniziale (2)

Replica ( 3)

Replica sincronizzata completata (4)

Recuperato (5)

Commit (6)

Sospeso (7)

Critico (8)

In attesa di avviare la risynchronization (9)

Risincronizzazione (10)

Risincronizzazione sospesa (11)

Failover in corso (12)

Failback in corso (13)

Failback completo (14)

Aggiornamento del disco in corso (15)

Nota