MSFT_VirtualDisk Klasse
Stellt ein Subsystemspeichervolume dar.
Die folgende Syntax ist eine Vereinfachung des Codes im Managed Object Format (MOF).
Syntax
class MSFT_VirtualDisk : MSFT_StorageObject
{
String FriendlyName;
String Name;
UInt16 NameFormat;
UInt16 UniqueIdFormat;
String UniqueIdFormatDescription;
UInt16 Usage;
String OtherUsageDescription;
UInt16 HealthStatus;
UInt16 OperationalStatus[];
String OtherOperationalStatusDescription;
String ResiliencySettingName;
UInt64 Size;
UInt64 AllocatedSize;
UInt64 LogicalSectorSize;
UInt64 PhysicalSectorSize;
UInt64 FootprintOnPool;
UInt16 ProvisioningType;
UInt16 NumberOfDataCopies;
UInt16 PhysicalDiskRedundancy;
UInt16 ParityLayout;
UInt16 NumberOfColumns;
UInt64 Interleave;
Boolean RequestNoSinglePointOfFailure;
UInt16 Access;
Boolean IsSnapshot;
Boolean IsManualAttach;
Boolean IsDeduplicationEnabled;
Boolean IsEnclosureAware;
UInt16 NumberOfAvailableCopies;
UInt16 DetachedReason;
UInt64 WriteCacheSize;
};
Member
Die MSFT_VirtualDisk Klasse weist folgende Typen von Membern auf:
Methoden
Die MSFT_VirtualDisk Klasse weist diese Methoden auf.
| Methode | Beschreibung |
|---|---|
| AddPhysicalDisk | Fügt einen oder mehrere physische Datenträger für die manuelle Zuordnung hinzu. |
| Anfügen | Fügt den virtuellen Datenträger an. |
| CreateClone | Erstellt einen neuen virtuellen Datenträger, der ein Klon des vorhandenen virtuellen Datenträgers ist. |
| CreateReplica | Erstellt eine Replikationsbeziehung zwischen virtuellen Datenträgern. |
| CreateSnapshot | Erstellt einen Klon eines virtuellen Datenträgers, der zu einem neuen virtuellen Datenträger führt, dessen Daten mit dem des ursprünglichen virtuellen Datenträgers identisch sind. |
| DeleteObject | Löscht den virtuellen Datenträger. |
| Trennen | Trennt den virtuellen Datenträger. |
| GetSecurityDescriptor | Ruft den Sicherheitsdeskriptor ab, der den Zugriff auf die Instanz des virtuellen Datenträgerobjekts steuert. |
| Ausblenden | Blendet den virtuellen Datenträger aus. |
| RemovePhysicalDisk | Entfernt einen oder mehrere physische Datenträger aus der manuellen Zuordnung. |
| Repair | Initiiert eine Reparatur des virtuellen Datenträgers, das Wiederherstellen von Daten und Redundanz auf unterschiedlichen (oder neuen) physischen Datenträgern innerhalb des Speicherpools. |
| Resize | Ändert die Größe des virtuellen Datenträgers. |
| SetAttributes | Legt verschiedene Attribute für den virtuellen Datenträger fest oder aktualisiert sie. |
| SetFriendlyName | Legt den Anzeigenamen für den virtuellen Datenträger fest. |
| SetReplicationRelationship | Legt die Replikationsbeziehung zwischen virtuellen Datenträgern fest. |
| SetSecurityDescriptor | Legt den Sicherheitsdeskriptor fest, der den Zugriff auf die Instanz des virtuellen Datenträgerobjekts steuert. |
| SetUsage | Legt die beabsichtigte Verwendung für den virtuellen Datenträger fest. |
| Show | Macht den virtuellen Datenträger verfügbar. |
Eigenschaften
Die MSFT_VirtualDisk Klasse weist diese Eigenschaften auf.
zugreifen
Datentyp: UInt16
Zugriffstyp: Schreibgeschützt
Gibt an, ob der virtuelle Datenträger für Lese- und Schreibzugriff verfügbar ist.
Unbekannt (0)
Lesbar (1)
Schreibbar (2)
Lese-/Schreibzugriff (3)
Einmal schreiben (4)
AllocatedSize
Datentyp: UInt64
Zugriffstyp: Schreibgeschützt
Qualifizierer: Erforderlich, Einheiten ("Bytes")
Die aktuell zugewiesene Größe des virtuellen Datenträgers. Wenn der Bereitstellungstyp des virtuellen Datenträgers behoben ist, sollte "AllocatedSize" gleich "Size" sein. Wenn "ProvisioningType" dünn ist, ist dieser Wert der tatsächlich zugewiesene Speicherplatz (der kleiner als "Size" sein muss).
DetachedReason
Datentyp: UInt16
Zugriffstyp: Schreibgeschützt
Der Grund, warum dieser virtuelle Datenträger getrennt ist. Diese Eigenschaft wird nur festgelegt, wenn der OperationalStatus des virtuellen Datenträgers losgelöst ist. Beachten Sie, dass dieses Feld für Speicherplätze spezifisch ist.
Unbekannt (0)
Keine (1)
Nach Richtlinie (2)
Hauptdatenträger sind fehlerhaft (3)
Unvollständig (4)
FootprintOnPool
Datentyp: UInt64
Zugriffstyp: Schreibgeschützt
Qualifizierer: Einheiten („Bytes“)
Die Gesamtkapazität des Speicherpools in Byte, die von diesem virtuellen Datenträger verbraucht wird. Bei einem gespiegelten virtuellen 2-Wege-Datenträger mit einer Größe von 1 GB würde der Speicherbedarf im Pool etwa 2 GB betragen.
FriendlyName
Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Kennzeichner: Erforderlich
Eine benutzerdefinierte, anzeigeorientierte Zeichenfolge mit dem Namen des virtuellen Datenträgers.
HealthStatus
Datentyp: UInt16
Zugriffstyp: Schreibgeschützt
Kennzeichner: Erforderlich
Der Integritätsstatus des virtuellen Datenträgers.
Die Integrität eines virtuellen Datenträgers wird von der Integrität der zugrunde stehenden physischen Datenträger abgeleitet, und ob der virtuelle Datenträger die erforderlichen Resilienzstufen beibehalten kann.
| Wert | Bedeutung |
|---|---|
| Gesund 0 | Alle physischen Datenträger sind vorhanden und befinden sich in einem gesunden Zustand. |
| Warnung 1 | Die meisten physischen Datenträger sind in Ordnung, aber einer oder mehrere können I/O-Anfragen nicht erfüllen. |
| Ungesunde 2 | Die meisten physischen Datenträger sind fehlerhaft oder in einem fehlerhaften Zustand, und der virtuelle Datenträger hat keine Datenintegrität mehr. |
| Unbekannt 5 | Der Integritätsstatus ist unbekannt. |
Verschachteln
Datentyp: UInt64
Zugriffstyp: Schreibgeschützt
Die Anzahl der Bytes, die einen Strip in allgemeinen Einstellungen für die Ausfallsicherheit bilden. Der Strip wird als Größe des Teils eines Stripes definiert, der auf einem physischen Datenträger liegt. So liefert Interleave * NumberOfColumns die Größe eines Streifens von Benutzerdaten.
IsDeduplicationEnabled
Datentyp: Boolean
Zugriffstyp: Lesen/Schreiben
TRUE , wenn die Datendeduplizierung für den virtuellen Datenträger aktiviert ist.
IsEnclosureAware
Datentyp: Boolean
Zugriffstyp: Schreibgeschützt
Das aktuelle Zuordnungsverhalten für diesen virtuellen Datenträger. Bei anlagenfähigen virtuellen Datenträgern werden die physischen Datenträger, die für ihre Redundanz verwendet werden sollen, intelligent ausgewählt. Bei TRUE versucht der virtuelle Datenträger, physische Datenträger aus verschiedenen Gehäusen zu verwenden, um die Fehlertoleranz zwischen zwei oder mehr physischen Gehäusen auszugleichen.
IsManualAttach
Datentyp: Boolean
Zugriffstyp: Lesen/Schreiben
TRUE , wenn dieser virtuelle Datenträger nur an das System angefügt wird, wenn ein expliziter Aufruf an die Attach-Methode erfolgt. Beachten Sie, dass diese Eigenschaft spezifisch für Speicherplätze ist.
IsSnapshot
Datentyp: Boolean
Zugriffstyp: Schreibgeschützt
TRUE , wenn dieser virtuelle Datenträger eine Schattenkopie eines anderen virtuellen Datenträgers ist.
LogicalSectorSize
Datentyp: UInt64
Zugriffstyp: Schreibgeschützt
Qualifizierer: Einheiten („Bytes“)
Die logische Sektorgröße des virtuellen Datenträgers in Byte.
Name
Datentyp: Zeichenkette
Zugriffstyp: Schreibgeschützt
Kennzeichner: Erforderlich
Ein halb eindeutiger (bereichsbezogenes Speichersubsystem), eine lesbare Zeichenfolge, die zum Identifizieren des virtuellen Datenträgers verwendet wird.
NameFormat
Datentyp: UInt16
Zugriffstyp: Schreibgeschützt
Kennzeichner: Erforderlich
Das Format der Name-Eigenschaft .
Unbekannt (0)
Sonstige (1)
VPD83NAA6 (2)
VPD83NAA5 (3)
VPD83Type2 (4)
VPD83Type1 (5)
VPD83Type0 (6)
SNVM (7)
NodeWWN (8)
NAA (9)
EUI64 (10)
T10VID (11)
NumberOfAvailableCopies
Datentyp: UInt16
Zugriffstyp: Schreibgeschützt
Die Anzahl der konsistenten Kopien der verfügbaren Daten.
NumberOfColumns
Datentyp: UInt16
Zugriffstyp: Schreibgeschützt
Die Anzahl der zugrunde liegenden physischen Datenträger, über die die Daten für diesen virtuellen Datenträger entfernt werden.
NumberOfDataCopies
Datentyp: UInt16
Zugriffstyp: Schreibgeschützt
Die Anzahl der vollständigen Datenkopien, die für den virtuellen Datenträger verwaltet werden. Beispielsweise verwaltet RAID 5 eine Kopie von Daten, während RAID 1 mindestens zwei Kopien verwaltet.
OperationalStatus
Datentyp: UInt16-Array
Zugriffstyp: Schreibgeschützt
Ein Array von Werten, die die aktuellen Betriebsbedingungen des virtuellen Datenträgers angeben. Im Gegensatz zu HealthStatus gibt diese Eigenschaft den Status von Hardware-, Software- und Infrastrukturproblemen im Zusammenhang mit diesem virtuellen Datenträger an und kann mehrere Werte enthalten.
| Wert | Bedeutung |
|---|---|
| Unbekannt 0 | Der Status des Vorgangs ist unbekannt. |
| Weitere 1 | Ein anbieterspezifischer OperationalStatus wurde durch Festlegen der Eigenschaft OtherOperationalStatusDescription angegeben. |
| OK 2 | Der virtuelle Datenträger reagiert auf Befehle und befindet sich in einem normalen Betriebszustand. |
| Herabgestuft 3 | Der virtuelle Datenträger reagiert auf Befehle, wird jedoch nicht in einem optimalen Betriebszustand ausgeführt. |
| Betont 4 | |
| Predictive Failure 5 | |
| Fehler 6 | |
| Nicht wiederherstellbarer Fehler 7 | |
| Ab 8 | |
| Beenden von 9 | |
| Beendet 10 | Der virtuelle Datenträger reagiert auf Befehle, wird jedoch nicht in einem optimalen Betriebszustand ausgeführt. |
| In Service 11 | Der virtuelle Datenträger wird konfiguriert, verwaltet, bereinigt oder anderweitig verwaltet. |
| Kein Kontakt 12 | |
| Verlorene Kommunikation 13 | |
| Abgebrochen 14 | |
| Ruhende 15 | |
| Unterstützen der Entität in Fehler 16 | |
| Abgeschlossen 17 | |
| Energiemodus 18 | |
| Neuzuweisung von 19 | |
| Getrennte 0xD002 | Dieser Wert ist für Windows reserviert. Der virtuelle Datenträger, der für das Hostsystem sichtbar ist, aber kein Datenträgergeräteobjekt besitzt. |
| Unvollständige 0xD003 | Der virtuelle Datenträger verfügt nicht über genügend Redundanz, um seine Daten erfolgreich zu reparieren oder neu zu generieren. |
OtherOperationalStatusDescription
Datentyp: Zeichenkette
Zugriffstyp: Schreibgeschützt
Wenn OperationalStatus "Other" enthält, handelt es sich bei dieser Eigenschaft um eine Zeichenfolge, die den vom Anbieter definierten Betriebsstatus enthält. Diese Eigenschaft muss NULL sein, wenn OperationalStatus keine 'Other' enthält.
OtherUsageDescription
Datentyp: Zeichenkette
Zugriffstyp: Schreibgeschützt
Wenn die Verwendungseigenschaft des virtuellen Datenträgers auf "Other" festgelegt ist, muss diese Eigenschaft eine Beschreibung der vom Anbieter oder benutzerdefinierten Verwendung definierten Verwendung enthalten. Wenn "Usage" nicht auf "Other" festgelegt ist, muss diese Eigenschaft NULL sein.
ParityLayout
Datentyp: UInt16
Zugriffstyp: Schreibgeschützt
Der Typ des Paritätslayouts, das für Paritätsbasierte Resilienzeinstellungen verwendet wird. Diese Eigenschaft sollte NULL sein, wenn der virtuelle Datenträger keine Paritätsbasierte Resilienzeinstellung verwendet.
Nicht gedrehte Parität (1)
Gedrehte Parität (2)
PhysicalDiskRedundancy
Datentyp: UInt16
Zugriffstyp: Schreibgeschützt
Die Anzahl der sichernden physischen Datenträger, die fehlschlagen können, ohne die Datenredundanz zu beeinträchtigen. Beispiel: RAID 0 kann keine Fehler tolerieren, RAID 5 kann einen einzelnen Laufwerksfehler tolerieren, und RAID 6 kann zwei Fehler tolerieren.
PhysicalSectorSize
Datentyp: UInt64
Zugriffstyp: Schreibgeschützt
Qualifizierer: Einheiten („Bytes“)
Die Größe des physischen Sektors des virtuellen Datenträgers in Byte.
ProvisioningType
Datentyp: UInt16
Zugriffstyp: Schreibgeschützt
Kennzeichner: Erforderlich
Das Bereitstellungsschema für den virtuellen Datenträger.
| Wert | Bedeutung |
|---|---|
| Unbekannt 0 | Das Bereitstellungsschema ist unbekannt. |
| Dünn 1 | Die Kapazität des virtuellen Datenträgers wird bei Bedarf zugewiesen. |
| Behoben 2 | Die Kapazität des virtuellen Datenträgers wird zur Erstellungszeit vollständig zugewiesen. |
RequestNoSinglePointOfFailure
Datentyp: Boolean
Zugriffstyp: Schreibgeschützt
Auf TRUE festgelegt, um keinen einzelnen Fehlerpunkt anzufordern.
ResiliencySettingName
Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifikatoren: Erforderlich, ModelCorrespondence {"MSFT_ResiliencySetting.Name"}
Der Name der Resilienzeinstellung für den virtuellen Datenträger.
Größe
Datentyp: UInt64
Zugriffstyp: Schreibgeschützt
Qualifizierer: Erforderlich, Einheiten ("Bytes")
Die logische Größe des virtuellen Datenträgers in Byte.
UniqueIdFormat
Datentyp: UInt16
Zugriffstyp: Schreibgeschützt
Qualifizierer: Erforderlich, Werte ( "Vendor Specific", "Vendor Id", "EUI64", "FCPH Name", "SCSI Name String" ), ValueMap ("0", "1", "2", "3", "8"), ModelCorrespondence {"MSFT_StorageObject.UniqueId"}
Der Typ des Bezeichners, der in der UniqueId-Eigenschaft verwendet wird, die diese Klasse von der MSFT_StorageObject Klasse erbt. Dieser Bezeichner muss der höchste verfügbare Bezeichner sein, wobei die folgende Einstellungsreihenfolge verwendet wird: 8 (höchste), 3, 2, 1, 0 (niedrigster Wert).
Wenn das virtuelle Datenträgergerät z. B. Bezeichner vom Typ 0, 1 und 3 verfügbar macht, muss UniqueId der Typ 3-Id sein, und UniqueIdFormat sollte auf 3 festgelegt werden.
UniqueIdFormatDescription
Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: ModelCorrespondence {"MSFT_StorageObject.UniqueId"}, ModelCorrespondence {"MSFT_VirtualDisk.UniqueIdFormat"}
Bestimmte Werte für UniqueIdFormat können verschiedene Unterformate enthalten. Diese Eigenschaft ist eine freiformatige Zeichenfolge, die verwendet wird, um das spezifische Format zu beschreiben, das in UniqueId verwendet wird.
Verwendung
Datentyp: UInt16
Zugriffstyp: Lesen/Schreiben
Kennzeichner: Erforderlich
Die beabsichtigte Verwendung für diesen virtuellen Datenträger.
Unbekannt (0)
Sonstige (1)
Unrestricted (2)
Reserviert für ComputerSystem (den Blockserver) (3)
Reserviert durch Replikationsdienste (4)
Reserviert durch Migrationsdienste (5)
Lokale Replikatquelle (6)
Remotereplikatquelle (7)
Lokales Replikatziel (8)
Remotereplikatziel (9)
Lokale Replikatquelle oder -ziel (10)
Remotereplikatquelle oder -ziel (11)
Delta-Replikatziel (12)
Elementkomponente (13)
Reserviert als Poolmitwirkender (14)
Zusammengesetztes Volumenelement (15)
Composite VirtualDisk Member (16)
Reserviert für Sparing (17)
WriteCacheSize
Datentyp: UInt64
Zugriffstyp: Schreibgeschützt
Die Größe des Schreibcaches für den virtuellen Datenträger.
Hinweise
Virtuelle Datenträger sind Einheiten des verwendbaren Speichers mit einem erweiterten Satz von Attributen im Vergleich zu physischen Datenträgern. Beispiele für die zusätzlichen Attribute sind Resilienz und dynamische Kapazitätserweiterung.
LUNs und Speicherplätze sind Beispiele für virtuelle Datenträger.
Virtuelle Datenträger, die für Windows verfügbar gemacht werden, werden als (Windows)-Datenträger für den Rest des Windows-Stapels angezeigt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Namespace | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |