Classe MSFT_VirtualDisk
Rappresenta un volume di archiviazione del sottosistema.
La sintassi seguente è semplificata dal codice MOF (Managed Object Format).
Sintassi
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;
};
Membri
La classe MSFT_VirtualDisk ha questi tipi di membri:
Metodi
La classe MSFT_VirtualDisk dispone di questi metodi.
| metodo | Descrizione |
|---|---|
| AddPhysicalDisk | Aggiunge uno o più dischi fisici per l'allocazione manuale. |
| Collega | Collega il disco virtuale. |
| CreateClone | Crea un nuovo disco virtuale che è un clone del disco virtuale esistente. |
| CreateReplica | Crea una relazione di replica tra dischi virtuali. |
| CreateSnapshot | Crea un clone di un disco virtuale, generando un nuovo disco virtuale i cui dati sono identici a quello del disco virtuale originale. |
| DeleteObject | Elimina il disco virtuale. |
| Scollega | Scollega il disco virtuale. |
| GetSecurityDescriptor | Recupera il descrittore di sicurezza che controlla l'accesso all'istanza dell'oggetto disco virtuale. |
| Nascondi | Nasconde il disco virtuale. |
| RemovePhysicalDisk | Rimuove uno o più dischi fisici dall'allocazione manuale. |
| Repair | Avvia un ripristino del disco virtuale, ripristinando i dati e la ridondanza in dischi fisici diversi (o nuovi) all'interno del pool di archiviazione. |
| Ridimensionamento | Ridimensiona il disco virtuale. |
| SetAttributes | Imposta o aggiorna vari attributi per il disco virtuale. |
| SetFriendlyName | Imposta il nome descrittivo per il disco virtuale. |
| SetReplicationRelationship | Imposta la relazione di replica tra dischi virtuali. |
| SetSecurityDescriptor | Imposta il descrittore di sicurezza che controlla l'accesso all'istanza dell'oggetto disco virtuale. |
| SetUsage | Imposta l'utilizzo previsto per il disco virtuale. |
| Mostra | Espone il disco virtuale. |
Proprietà
La classe MSFT_VirtualDisk ha queste proprietà.
Accesso
Tipo di dati: UInt16
Tipo di accesso: sola lettura
Indica se il disco virtuale è disponibile per l'accesso in lettura e scrittura.
Sconosciuto (0)
Leggibile (1)
Scrivibile (2)
Lettura/scrittura (3)
Write Once (4)
AllocateSize
Tipo di dati: UInt64
Tipo di accesso: sola lettura
Qualificatori: obbligatorio, unità ("byte")
Dimensioni attualmente allocate del disco virtuale. Se provisioningType del disco virtuale è fisso, AllocateSize deve essere uguale a Size. Se ProvisioningType è Thin, questo valore corrisponde alla quantità di spazio effettivamente allocata (che deve essere minore di Size).
DetachedReason
Tipo di dati: UInt16
Tipo di accesso: sola lettura
Motivo per cui questo disco virtuale viene scollegato. Questa proprietà verrà impostata solo quando OperationalStatus del disco virtuale include Detached. Si noti che questo campo è specifico per gli spazi di archiviazione.
Sconosciuto (0)
Nessuno (1)
Per criterio (2)
Maggioranza dischi non integri (3)
Incompleto (4)
FootprintOnPool
Tipo di dati: UInt64
Tipo di accesso: sola lettura
Qualificatori: unità ("byte")
Capacità totale del pool di archiviazione, in byte, utilizzata da questo disco virtuale. Ad esempio, nel caso di un disco virtuale con mirroring a 2 vie con dimensioni pari a 1 GB, il footprint nel pool sarà di circa 2 GB.
FriendlyName
Tipo di dati: String
Tipo di accesso: sola lettura
Qualificatori: obbligatorio
Stringa orientata alla visualizzazione impostata dall'utente contenente il nome del disco virtuale.
HealthStatus
Tipo di dati: UInt16
Tipo di accesso: sola lettura
Qualificatori: obbligatorio
Stato di integrità del disco virtuale.
L'integrità di un disco virtuale è derivata dall'integrità dei dischi fisici di backup e dal fatto che il disco virtuale possa mantenere i livelli di resilienza necessari.
| Valore | Significato |
|---|---|
| Integro 0 | Tutti i dischi fisici sono presenti e in uno stato integro. |
| Avviso 1 | La maggior parte dei dischi fisici è integra, ma una o più richieste di I/O potrebbero non riuscire. |
| Non integro 2 | La maggior parte dei dischi fisici non è integra o in uno stato di errore e il disco virtuale non dispone più dell'integrità dei dati. |
| Sconosciuto 5 | Lo stato di integrità è sconosciuto. |
Interleave
Tipo di dati: UInt64
Tipo di accesso: sola lettura
Numero di byte che formeranno una strip in impostazioni di resilienza comuni basate su striping. La striscia è definita come la dimensione della parte di una striscia che si trova su un disco fisico. Pertanto, Interleave * NumberOfColumns restituirà le dimensioni di una striscia di dati utente.
IsDeduplicazioneEnabled
Tipo di dati: Boolean
Tipo di accesso: lettura/scrittura
TRUE se la deduplicazione dei dati è abilitata per il disco virtuale.
IsEnclosureAware
Tipo di dati: Boolean
Tipo di accesso: sola lettura
Comportamento di allocazione corrente per questo disco virtuale. I dischi virtuali con riconoscimento dell'enclosure selezioneranno in modo intelligente i dischi fisici da usare per la ridondanza. Se TRUE, il disco virtuale tenterà di usare dischi fisici di enclosure diversi per bilanciare la tolleranza di errore tra due o più enclosure fisici.
IsManualAttach
Tipo di dati: Boolean
Tipo di accesso: lettura/scrittura
TRUE se il disco virtuale verrà collegato al sistema solo se viene effettuata una chiamata esplicita al metodo Attach . Si noti che questa proprietà è specifica per gli spazi di archiviazione.
IsSnapshot
Tipo di dati: Boolean
Tipo di accesso: sola lettura
TRUE se il disco virtuale è una copia shadow di un altro disco virtuale.
LogicalSectorSize
Tipo di dati: UInt64
Tipo di accesso: sola lettura
Qualificatori: unità ("byte")
Dimensioni del settore logico del disco virtuale, in byte.
Nome
Tipo di dati: String
Tipo di accesso: sola lettura
Qualificatori: obbligatorio
Stringa semi-univoca (con ambito nel sottosistema di archiviazione proprietario), stringa leggibile usata per identificare il disco virtuale.
NameFormat
Tipo di dati: UInt16
Tipo di accesso: sola lettura
Qualificatori: obbligatorio
Formato della proprietà Name .
Sconosciuto (0)
Altro (1)
VPD83NAA6 (2)
VPD83NAA5 (3)
VPD83Type2 (4)
VPD83Type1 (5)
VPD83Type0 (6)
SNVM (7)
NodeWWN (8)
NAA (9)
EUI64 (10)
T10VID (11)
NumberOfAvailableCopies
Tipo di dati: UInt16
Tipo di accesso: sola lettura
Numero di copie coerenti dei dati disponibili.
NumberOfColumns
Tipo di dati: UInt16
Tipo di accesso: sola lettura
Numero di dischi fisici sottostanti in cui vengono con striping i dati per questo disco virtuale.
NumberOfDataCopies
Tipo di dati: UInt16
Tipo di accesso: sola lettura
Numero di copie di dati complete che vengono mantenute per il disco virtuale. Ad esempio, RAID 5 mantiene una copia dei dati, mentre RAID 1 mantiene almeno due copie.
OperationalStatus
Tipo di dati: matrice UInt16
Tipo di accesso: sola lettura
Matrice di valori che indicano le condizioni operative correnti del disco virtuale. A differenza di HealthStatus, questa proprietà indica lo stato dei problemi hardware, software e dell'infrastruttura correlati a questo disco virtuale e può contenere più valori.
| Valore | Significato |
|---|---|
| Sconosciuto 0 | Lo stato operativo è sconosciuto. |
| Altri 1 | Un elemento OperationalStatus specifico del fornitore è stato specificato impostando la proprietà OtherOperationalStatusDescription. |
| OK 2 | Il disco virtuale risponde ai comandi e si trova in uno stato operativo normale. |
| Degradato 3 | Il disco virtuale risponde ai comandi, ma non è in esecuzione in uno stato operativo ottimale. |
| Sottolineato 4 | |
| Errore predittivo 5 | |
| Errore 6 | |
| Errore non ripristinabile 7 | |
| A partire da 8 | |
| Arresto di 9 | |
| Arrestato 10 | Il disco virtuale risponde ai comandi, ma non è in esecuzione in uno stato operativo ottimale. |
| Nel servizio 11 | Il disco virtuale viene configurato, gestito, pulito o gestito in altro modo. |
| Nessun contatto 12 | |
| Comunicazione persa 13 | |
| Interrotto 14 | |
| Inattivo 15 | |
| Supporto dell'entità nell'errore 16 | |
| Completato 17 | |
| Modalità alimentazione 18 | |
| Rilocazione di 19 | |
| 0xD002 scollegate | Questo valore è riservato a Windows. Il disco virtuale visibile al sistema host ma non dispone di un oggetto dispositivo disco. |
| 0xD003 incompleti | Il disco virtuale non dispone di una ridondanza sufficiente per ripristinare o rigenerare correttamente i dati. |
OtherOperationalStatusDescription
Tipo di dati: String
Tipo di accesso: sola lettura
Se OperationalStatus contiene Other, questa proprietà è una stringa contenente lo stato operativo definito dal fornitore. Questa proprietà deve essere NULL se OperationalStatus non contiene Other.
OtherUsageDescription
Tipo di dati: String
Tipo di accesso: sola lettura
Se la proprietà Usage del disco virtuale è impostata su Other, questa proprietà deve contenere una descrizione dell'utilizzo definito dal fornitore o dall'utente. Se Usage non è impostato su Other, questa proprietà deve essere NULL.
ParityLayout
Tipo di dati: UInt16
Tipo di accesso: sola lettura
Tipo di layout di parità usato per le impostazioni di resilienza basate sulla parità. Questa proprietà deve essere NULL se il disco virtuale non usa un'impostazione di resilienza basata sulla parità.
Parità non ruotata (1)
Parità ruotata (2)
PhysicalDiskRedundancy
Tipo di dati: UInt16
Tipo di accesso: sola lettura
Numero di dischi fisici di backup che possono non riuscire senza compromettere la ridondanza dei dati. Ad esempio: RAID 0 non può tollerare errori, RAID 5 può tollerare un singolo errore di unità e RAID 6 può tollerare due errori.
PhysicalSectorSize
Tipo di dati: UInt64
Tipo di accesso: sola lettura
Qualificatori: unità ("byte")
Dimensioni del settore fisico del disco virtuale, in byte.
ProvisioningType
Tipo di dati: UInt16
Tipo di accesso: sola lettura
Qualificatori: obbligatorio
Schema di provisioning per il disco virtuale.
| Valore | Significato |
|---|---|
| Sconosciuto 0 | Lo schema di provisioning è sconosciuto. |
| Sottile 1 | La capacità del disco virtuale viene allocata su richiesta. |
| Correzione 2 | La capacità del disco virtuale viene allocata completamente in fase di creazione. |
RequestNoSinglePointOfFailure
Tipo di dati: Boolean
Tipo di accesso: sola lettura
Impostare su TRUE per richiedere nessun singolo punto di errore.
ResiliencySettingName
Tipo di dati: String
Tipo di accesso: sola lettura
Qualificatori: Obbligatorio, ModelCorrespondence {"MSFT_ResiliencySetting.Name"}
Nome dell'impostazione di resilienza per il disco virtuale.
Dimensione
Tipo di dati: UInt64
Tipo di accesso: sola lettura
Qualificatori: obbligatorio, unità ("byte")
Dimensioni logiche, in byte, del disco virtuale.
UniqueIdFormat
Tipo di dati: UInt16
Tipo di accesso: sola lettura
Qualificatori: Obbligatorio, Valori ( "Vendor Specific", "Vendor Id", "EUI64", "FCPH Name", "SCSI Name String" ), ValueMap ("0", "1", "2", "3", "8"), ModelCorrespondence {"MSFT_StorageObject.UniqueId"}
Tipo di identificatore utilizzato nella proprietà UniqueId che questa classe eredita dalla classe MSFT_StorageObject . Questo identificatore deve essere l'identificatore più alto disponibile usando l'ordine di preferenza seguente: 8 (massimo), 3, 2, 1, 0 (più basso).
Ad esempio, se il dispositivo disco virtuale espone gli identificatori di tipo 0, 1 e 3, UniqueId deve essere il tipo 3 identificatore e UniqueIdFormat deve essere impostato su 3.
UniqueIdFormatDescription
Tipo di dati: String
Tipo di accesso: sola lettura
Qualificatori: ModelCorrespondence {"MSFT_StorageObject.UniqueId"}, ModelCorrespondence {"MSFT_VirtualDisk.UniqueIdFormat"}
Alcuni valori per UniqueIdFormat possono includere vari formati secondari. Questa proprietà è una stringa in formato libero utilizzata per descrivere il formato specifico usato in UniqueId.
Utilizzo
Tipo di dati: UInt16
Tipo di accesso: lettura/scrittura
Qualificatori: obbligatorio
Utilizzo previsto per questo disco virtuale.
Sconosciuto (0)
Altro (1)
Senza restrizioni (2)
Riservato per ComputerSystem (server a blocchi) (3)
Riservato dai servizi di replica (4)
Riservato da Servizi di migrazione (5)
Origine replica locale (6)
Origine replica remota (7)
Destinazione replica locale (8)
Destinazione replica remota (9)
Origine o destinazione della replica locale (10)
Origine replica remota o destinazione (11)
Destinazione replica differenziale (12)
Componente elemento (13)
Riservato come collaboratore pool (14)
Membro volume composito (15)
Membro Composite VirtualDisk (16)
Riservato per sparing (17)
WriteCacheSize
Tipo di dati: UInt64
Tipo di accesso: sola lettura
Dimensioni della cache di scrittura per il disco virtuale.
Osservazioni:
I dischi virtuali sono unità di archiviazione utilizzabili con un set espanso di attributi rispetto ai dischi fisici. Esempi di attributi aggiuntivi includono resilienza ed estensione della capacità dinamica.
I LUN e gli spazi di archiviazione sono esempi di dischi virtuali.
I dischi virtuali, quando esposti a Windows, vengono visualizzati come dischi (Windows) nel resto dello stack di Windows.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 [solo app desktop] |
| Server minimo supportato | Windows Server 2012 [solo app desktop] |
| Spazio dei nomi | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |