Condividi tramite

classe Msvm_SerialPort

  • Articolo

Rappresenta una porta seriale associata al controller seriale.

La sintassi seguente è il codice MOF (Managed Object Format) semplificato e include tutte le proprietà ereditate.

Sintassi

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_SerialPort : CIM_LogicalPort
{
  string   InstanceID;
  string   Caption;
  string   Description = "Microsoft Virtual Serial Port";
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[] = { 2 };
  string   StatusDescriptions[] = { "OK" };
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 5;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_ComputerSystem";
  string   SystemName;
  string   CreationClassName = "Msvm_SerialPort";
  string   DeviceID;
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability = 6;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint64   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  uint16   AdditionalAvailability[] = { 6 };
  uint64   MaxQuiesceTime;
  uint64   Speed = 115200;
  uint32   MaxSpeed = 115200;
  uint64   RequestedSpeed = 115200;
  uint16   UsageRestriction = 4;
  uint16   PortType = 1;
  string   OtherPortType = "Serial Port";
};

Members

La classe Msvm_SerialPort include questi tipi di membri:

Metodi

La classe Msvm_SerialPort include questi metodi.

Metodo Descrizione
EnableDevice Questo metodo non è supportato.
OnlineDevice Questo metodo non è supportato.
QuiesceDevice Questo metodo non è supportato.
RequestStateChange Richiede una modifica dello stato.
Reimpostazione Reimposta il dispositivo virtuale.
RestoreProperties Questo metodo non è supportato.
SaveProperties Questo metodo non è supportato.
SetPowerState Questo metodo non è supportato.

Proprietà

La classe Msvm_SerialPort ha queste proprietà.

Disponibilità aggiuntiva

Tipo di dati: matrice uint16

Tipo di accesso: sola lettura

Qualsiasi disponibilità e stato aggiuntivo del dispositivo. Questa proprietà viene ereditata da CIM_LogicalDevice.

Valore Significato
{ 6 }
6
 Non applicabile

Disponibilità

Tipo di dati: uint16

Tipo di accesso: sola lettura

Disponibilità primaria e stato del dispositivo. Questa proprietà viene ereditata da CIM_LogicalDevice.

Valore Significato
6
 Non applicabile

AvailableRequestedStates

Tipo di dati: matrice uint16

Tipo di accesso: sola lettura

Indica i valori possibili per il parametro RequestedState del metodo RequestStateChange . Questa proprietà viene ereditata da CIM_EnabledLogicalElement, ma non viene usata.

Didascalia

Tipo di dati: stringa

Tipo di accesso: sola lettura

Breve descrizione dell'oggetto. Questa proprietà viene ereditata da CIM_ManagedElement.

CommunicationStatus

Tipo di dati: uint16

Tipo di accesso: sola lettura

Indica la capacità della strumentazione di comunicare con l'elemento gestito sottostante. Un valore Null indica che questa proprietà non è implementata. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Sconosciuto (0)

Non disponibile (1)

Comunicazione OK (2)

Comunicazione persa (3)

Nessun contatto (4)

DMTF Riservato (..)

Fornitore riservato (0x8000.).

CreationClassName

Tipo di dati: stringa

Tipo di accesso: sola lettura

Nome della classe o della sottoclasse utilizzata nella creazione di un'istanza. Questa proprietà viene ereditata da CIM_LogicalDevice.

Descrizione

Tipo di dati: stringa

Tipo di accesso: sola lettura

Descrizione dell'oggetto . Questa proprietà viene ereditata da CIM_ManagedElement.

DetailedStatus

Tipo di dati: uint16

Tipo di accesso: sola lettura

Complimenta la proprietà PrimaryStatus con dettagli di stato aggiuntivi. Un valore Null indica che questa proprietà non è implementata. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Non disponibile (0)

Nessuna informazione aggiuntiva (1)

Stressato (2)

Errore predittivo (3)

Errore non recuperabile (4)

Entità di supporto nell'errore (5)

DMTF Riservato (..)

Fornitore riservato (0x8000.).

Deviceid

Tipo di dati: stringa

Tipo di accesso: sola lettura

Questa proprietà viene ereditata da CIM_LogicalDevice ed è impostata su "Microsoft:GUID\device-specific-data", dove i dati specifici del dispositivo sono facoltativi.

ElementName

Tipo di dati: string

Tipo di accesso: sola lettura

Nome visualizzato per l'oggetto. Questa proprietà viene ereditata da CIM_ManagedElement.

EnabledDefault

Tipo di dati: uint16

Tipo di accesso: sola lettura

Configurazione predefinita o di avvio di un amministratore per lo stato abilitato di un elemento. Questa proprietà viene ereditata da CIM_EnabledLogicalElement.

Valore Significato
2
 Attivato

EnabledState

Tipo di dati: uint16

Tipo di accesso: sola lettura

Stato abilitato dell'elemento. Può anche indicare le transizioni tra questi stati richiesti. Questa proprietà viene ereditata da CIM_EnabledLogicalElement.

Valore Significato
5
 Non applicabile

ErrorCleared

Tipo di dati: booleano

Tipo di accesso: sola lettura

Indica se l'errore segnalato nella proprietà LastErrorCode è stato cancellato. Questa proprietà viene ereditata da CIM_LogicalDevice, ma non viene utilizzata.

ErrorDescription

Tipo di dati: string

Tipo di accesso: sola lettura

Stringa che fornisce ulteriori informazioni sull'errore registrato nella proprietà LastErrorCode e informazioni sulle azioni correttive che possono essere eseguite. Questa proprietà viene ereditata da CIM_LogicalDevice, ma non viene utilizzata.

HealthState

Tipo di dati: uint16

Tipo di accesso: sola lettura

Integrità corrente dell'elemento. Ciò esprime l'integrità di questo elemento, ma non necessariamente quella dei relativi sottocomponenti. I valori possibili sono da 0 a 30, dove 5 indica che l'elemento è completamente integro e 30 indica che l'elemento è completamente non funzionale. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

IdentifyingDescriptions

Tipo di dati: matrice di stringhe

Tipo di accesso: sola lettura

Matrice di stringhe in formato libero che forniscono spiegazioni e dettagli dietro le voci nella matrice di proprietà OtherIdentifyingInfo . Questa proprietà viene ereditata da CIM_LogicalDevice e viene impostata su Null.

InstallDate

Tipo di dati: datetime

Tipo di accesso: sola lettura

Data e ora di creazione della configurazione della macchina virtuale. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

InstanceID

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: Chiave

Identifica in modo univoco un'istanza di questa classe. Questa proprietà viene ereditata da CIM_ManagedElement.

LastErrorCode

Tipo di dati: uint32

Tipo di accesso: sola lettura

Ultimo codice di errore segnalato dal dispositivo logico. Questa proprietà viene ereditata da CIM_LogicalDevice, ma non viene utilizzata.

MaxQuiesceTime

Tipo di dati: uint64

Tipo di accesso: sola lettura

La proprietà è stata deprecata. Questa proprietà viene ereditata da CIM_LogicalDevice.

Maxspeed

Tipo di dati: uint32

Tipo di accesso: sola lettura

Larghezza di banda massima della porta, in bit al secondo. Questa proprietà viene ereditata da CIM_LogicalPort.

Nome

Tipo di dati: string

Tipo di accesso: sola lettura

Etichetta in base alla quale è noto l'oggetto. Questa proprietà viene ereditata da CIM_ManagedSystemElement e corrisponde alla proprietà ElementName .

OperatingStatus

Tipo di dati: uint16

Tipo di accesso: sola lettura

Fornisce informazioni sullo stato correnti per la condizione operativa dell'elemento e può essere utilizzata per fornire maggiori dettagli rispetto al valore della proprietà EnabledState . Un valore Null indica che questa proprietà non è implementata. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Sconosciuto (0)

Non disponibile (1)

Manutenzione (2)

Avvio (3)

Arresto (4)

Arrestato (5)

Interrotto (6)

Dormiente (7)

Completato (8)

Migrazione (9)

Emigrazione (10)

Immigrating (11)

Creazione di snapshot (12)

Arresto (13)

In test (14)

Transizione (15)

In servizio (16)

DMTF Riservato (..)

Fornitore riservato (0x8000.. )

OperationalStatus

Tipo di dati: matrice uint16

Tipo di accesso: sola lettura

Stati correnti dell'oggetto. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

OtherEnabledState

Tipo di dati: string

Tipo di accesso: sola lettura

Stringa che descrive lo stato abilitato o disabilitato dell'elemento quando la proprietà EnabledState è impostata su 1 (Other). Questa proprietà deve essere impostata su Null quando EnabledState è un valore diverso da 1. Questa proprietà viene ereditata da CIM_EnabledLogicalElement.

OtherIdentifyingInfo

Tipo di dati: matrice di stringhe

Tipo di accesso: sola lettura

Eventuali dati aggiuntivi, oltre alle informazioni sull'ID dispositivo, che possono essere usati per identificare un dispositivo logico. Questa proprietà viene ereditata da CIM_LogicalDevice e viene impostata su Null.

OtherPortType

Tipo di dati: string

Tipo di accesso: sola lettura

Tipo di modulo, quando PortType è impostato su 1 (Altro). Questa proprietà viene ereditata da CIM_LogicalPort.

Porttype

Tipo di dati: uint16

Tipo di accesso: sola lettura

Questa proprietà viene ereditata da CIM_LogicalPort.

Valore Significato
1
 Altro

PowerManagementCapabilities

Tipo di dati: matrice uint16

Tipo di accesso: sola lettura

Funzionalità di risparmio energia del dispositivo. Questa proprietà viene ereditata da CIM_LogicalDevice, ma non viene utilizzata.

PowerManagementSupported

Tipo di dati: booleano

Tipo di accesso: sola lettura

Indica se il dispositivo può essere gestito dall'alimentazione. Questa proprietà viene ereditata da CIM_LogicalDevice, ma non viene utilizzata.

PowerOnHours

Tipo di dati: uint64

Tipo di accesso: sola lettura

Numero di ore consecutive attivate da questo dispositivo dall'ultimo ciclo di alimentazione. Questa proprietà viene ereditata da CIM_LogicalDevice, ma non viene utilizzata.

PrimaryStatus

Tipo di dati: uint16

Tipo di accesso: sola lettura

Fornisce informazioni generali sullo stato. Questa proprietà deve essere utilizzata insieme alla proprietà DetailedStatus per fornire lo stato di integrità generale e dettagliato dell'elemento e dei relativi sottocomponenti. Un valore Null indica che questa proprietà non è implementata. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Sconosciuto (0)

OK (1)

Degradato (2)

Errore (3)

DMTF Riservato (..)

Fornitore riservato (0x8000.. )

RequestedSpeed

Tipo di dati: uint64

Tipo di accesso: sola lettura

Larghezza di banda richiesta della porta, in bit al secondo. Questa proprietà viene ereditata da CIM_LogicalPort.

RequestedState

Tipo di dati: uint16

Tipo di accesso: sola lettura

Ultimo stato richiesto o desiderato per l'elemento. Lo stato effettivo dell'elemento è rappresentato da EnabledState. Questa proprietà viene fornita per confrontare gli ultimi stati abilitati o disabilitati richiesti. Questa proprietà viene ereditata da CIM_EnabledLogicalElement.

Valore Significato
12
 Non applicabile

Velocità

Tipo di dati: uint64

Tipo di accesso: sola lettura

Larghezza di banda della porta, in bit al secondo. Questa proprietà viene ereditata da CIM_LogicalPort.

Status

Tipo di dati: string

Tipo di accesso: sola lettura

Stato corrente dell'oggetto. Questa proprietà viene ereditata da CIM_ManagedSystemElement, ma non viene utilizzata.

StatusDescriptions

Tipo di dati: matrice di stringhe

Tipo di accesso: sola lettura

Stringhe che descrivono i vari valori della matrice OperationalStatus . Questa proprietà viene ereditata da CIM_ManagedSystemElement.

StatusInfo

Tipo di dati: uint16

Tipo di accesso: sola lettura

Stato corrente del dispositivo logico. Questa proprietà viene ereditata da CIM_LogicalDevice, ma non viene utilizzata.

SystemCreationClassName

Tipo di dati: string

Tipo di accesso: sola lettura

Nome della classe di creazione del sistema di ambito. Questa proprietà viene ereditata da CIM_LogicalDevice.

Systemname

Tipo di dati: stringa

Tipo di accesso: sola lettura

Identificatore univoco per la macchina virtuale di ambito. Questa proprietà viene ereditata da CIM_LogicalDevice.

TimeOfLastStateChange

Tipo di dati: datetime

Tipo di accesso: sola lettura

Data o ora in cui lo stato abilitato dell'elemento è stato modificato. Questa proprietà viene ereditata da CIM_EnabledLogicalElement e viene sempre impostata su Null.

TotalPowerOnHours

Tipo di dati: uint64

Tipo di accesso: sola lettura

Numero totale di ore di alimentazione del dispositivo. Questa proprietà viene ereditata da CIM_LogicalDevice, ma non viene usata.

Transizione diToState

Tipo di dati: uint16

Tipo di accesso: sola lettura

Indica lo stato di destinazione a cui viene eseguita la transizione dell'istanza. Questa proprietà viene ereditata da CIM_EnabledLogicalElement, ma non viene usata.

UsageRestriction

Tipo di dati: uint16

Tipo di accesso: sola lettura

In alcune circostanze, una porta logica potrebbe essere identificabile come porta front-end o back-end. Un esempio di questa situazione è una matrice di archiviazione che potrebbe avere porte back-end per comunicare con unità disco e porte front-end per comunicare con gli host. Se non esiste alcuna restrizione sull'uso della porta, il valore deve essere impostato su 4 (Non limitato). Questa proprietà viene ereditata da CIM_LogicalPort.

Valore Significato
4
 Non limitato

Commenti

L'accesso alla classe Msvm_SerialPort potrebbe essere limitato dal filtro dell'interfaccia utente. Per altre informazioni, vedere Controllo account utente e WMI.

Requisiti

Requisito Valore
Client minimo supportato
 Windows 8 [solo app desktop]
Server minimo supportato
 Windows Server 2012 [solo app desktop]
Spazio dei nomi
 Root\Virtualization\V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

Vedi anche

CIM_LogicalPort

CIM_LogicalPort

Classi di dispositivi seriali