Método CreateVirtualDisk de la clase MSFT_StorageSubSystem
Crea un nuevo disco virtual.
Sintaxis
UInt32 CreateVirtualDisk(
[in] String FriendlyName,
[in] UInt16 Usage,
[in] String OtherUsageDescription,
[in, out] UInt64 Size,
[in] Boolean UseMaximumSize,
[in] UInt16 NumberOfDataCopies,
[in] UInt16 PhysicalDiskRedundancy,
[in] UInt16 NumberOfColumns,
[in] UInt64 Interleave,
[in] UInt16 ParityLayout,
[in] Boolean RequestNoSinglePointOfFailure,
[in] Boolean IsEnclosureAware,
[in] UInt16 ProvisioningType,
[in] Boolean RunAsJob,
[out] String CreatedVirtualDisk,
[out] MSFT_StorageJob REF CreatedStorageJob,
[out] String ExtendedStatus
);
Parámetros
FriendlyName [in]
Nombre descriptivo del disco virtual.
Se espera que los nombres descriptivos sean descriptivos, pero no son necesarios para ser únicos. Tenga en cuenta que algunos subsistemas de almacenamiento no permiten establecer un nombre descriptivo durante la creación del disco virtual. Si un subsistema no admite esto, la creación del disco virtual debe seguir siendo correcta, pero es posible que el disco tenga un nombre diferente asignado.
Este parámetro es obligatorio y no puede ser NULL.
Uso [in]
Especifica el uso previsto para el disco virtual.
Puede especificar una descripción predefinida o una descripción personalizada. Para especificar una descripción predefinida, use un valor distinto de Other.
Para especificar una descripción personalizada, use Other y especifique un valor distinto de NULL para el parámetro OtherUsageDescription .
Otros (1)
Sin restricciones (2)
Reservado para ComputerSystem (el servidor de bloqueo) (3)
Reservado por Replication Services (4)
Reservado por Migration Services (5)
Origen de réplica local (6)
Origen de réplica remota (7)
Destino de réplica local (8)
Destino de réplica remota (9)
Origen o destino de réplica local (10)
Origen o destino de réplica remota (11)
Destino de réplica delta (12)
Componente de elemento (13)
Reservado como colaborador del grupo (14)
Miembro de volumen compuesto (15)
Miembro compuesto de VirtualDisk (16)
Reservado para sparing (17)
OtherUsageDescription [in]
Un uso específico del proveedor para el nuevo disco virtual. Este parámetro solo se puede especificar si el parámetro Usage está establecido en Other.
Tamaño [dentro, fuera]
Tamaño deseado, en bytes, del disco virtual. Tenga en cuenta que algunos subsistemas de almacenamiento redondearán el tamaño hacia arriba o hacia abajo hasta un múltiplo de su tamaño de unidad de asignación.
El subsistema de almacenamiento usa este parámetro solo si el parámetro UseMaximumSize es FALSE o NULL.
Si el parámetro UseMaximumSize es TRUE, este parámetro se omite.
Este parámetro es obligatorio y no puede ser cero.
UseMaximumSize [in]
Si es TRUE, use el tamaño máximo disponible para crear el disco virtual.
Este parámetro no se puede usar junto con el parámetro Size .
NumberOfDataCopies [in]
Número de copias de datos completas que se mantendrán para este disco virtual.
PhysicalDiskRedundancy [in]
Número de errores de disco físico que el disco virtual debe soportar antes de que se produzca la pérdida de datos.
NumberOfColumns [in]
Número de discos físicos subyacentes en los que se deben seccionar los datos. Este parámetro es obligatorio.
Intercalar [in]
Número de bytes que se deben usar para una franja en la configuración de resistencia basada en el seccionamiento común. La franja se define como el tamaño de la parte de una franja que se encuentra en un disco físico. Por lo tanto , Interleave * NumberOfColumns producirá el tamaño de una franja. Este parámetro es obligatorio.
ParityLayout [in]
Si se desea una configuración de resistencia basada en paridad, establezca este parámetro en uno de los valores siguientes.
Si la configuración de resistencia deseada no está basada en paridad, esta propiedad debe ser NULL.
Paridad no rotada (1)
Paridad rotada (2)
RequestNoSinglePointOfFailure [in]
Establézcalo en TRUE para solicitar ningún único punto de error.
IsEnclosureAware [in]
Comportamiento de asignación de este disco virtual. Los discos virtuales compatibles con el gabinete elegirán de forma inteligente los discos físicos que se usarán para su redundancia. Si es TRUE, el disco virtual intentará usar discos físicos de contenedores diferentes para equilibrar la tolerancia a errores entre dos o más gabinetes físicos.
ProvisioningType [in]
Tipo de aprovisionamiento para el disco virtual.
Fino (1)
Corregido (2)
RunAsJob [in]
Si es TRUE, este método usa el parámetro CreatedStorageJob cuando la solicitud tarda mucho tiempo en atenderse. Si se ha creado un trabajo de almacenamiento para realizar un seguimiento de la operación, este método devolverá Parámetros de método activados: trabajo iniciado.
Nota
Incluso si RunAsJob es TRUE, este método todavía puede devolver un resultado si ha terminado en tiempo suficiente.
Si es FALSE o NULL, este método seguirá el comportamiento asincrónico de WMI predeterminado determinado por el método del cliente para la invocación. En otras palabras, es sincrónico a menos que se solicite lo contrario.
CreatedVirtualDisk [out]
Si el disco virtual se crea correctamente, este parámetro recibe una cadena que contiene un objeto MSFT_VirtualDisk incrustado.
CreatedStorageJob [out]
Si RunAsJob se establece en TRUE y este método tarda mucho tiempo en ejecutarse, este parámetro recibe una referencia al objeto de trabajo de almacenamiento que se usa para realizar un seguimiento de la operación de ejecución prolongada.
ExtendedStatus [out]
Cadena que contiene un objeto MSFT_StorageExtendedStatus incrustado.
Este parámetro permite al proveedor de almacenamiento devolver información de error extendida (específica de la implementación).
Valor devuelto
Correcto (0)
No compatible (1)
Error no especificado (2)
Tiempo de espera (3)
Error (4)
Parámetro no válido (5)
Parámetros del método activados: trabajo iniciado (4096)
Tamaño no admitido (4097)
Espacio libre insuficiente (40000)
Acceso denegado (40001)
No hay suficientes recursos para completar la operación. (40002)
Caché obsoleta (40003)
Debe especificar un tamaño mediante el parámetro Size o UseMaximumSize. Solo puede especificar uno de estos parámetros a la vez. (40005)
No se puede conectar al proveedor de almacenamiento. (46000)
El proveedor de almacenamiento no puede conectarse al subsistema de almacenamiento. (46001)
No se encontró ningún grupo de almacenamiento que admita esta configuración de disco virtual. (47000)
No se admite el valor de NoSinglePointOfFailure. (49001)
El valor de PhysicalDiskRedundancy está fuera del intervalo de valores admitido. (49002)
El valor de NumberOfDataCopies está fuera del intervalo de valores admitido. (49003)
El valor de ParityLayout está fuera del intervalo de valores admitido. (49004)
El valor de Interleave está fuera del intervalo de valores admitido. (49005)
El valor de NumberOfColumns está fuera del intervalo de valores admitido. (49006)
Comentarios
Este método se usa normalmente cuando se cumple una de las siguientes condiciones:
- Los grupos de almacenamiento del subsistema de almacenamiento no permiten la creación directa de discos virtuales.
- El subsistema de almacenamiento no admite grupos de almacenamiento.
Los proveedores de administración de almacenamiento también pueden optar por implementar este método para elegir de forma "inteligente" un grupo de almacenamiento para el usuario. Si se admite este método, la propiedad SupportsAutomaticStoragePoolSelection del subsistema debe establecerse en TRUE.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2012 [solo aplicaciones de escritorio] |
| Espacio de nombres | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |