Freigeben über

CreateStoragePool-Methode der MSFT_StorageSubSystem-Klasse

  • Artikel

Erstellt einen Speicherpool aus verfügbaren physischen Datenträgern, die in einem gemeinsamen Urpool enthalten sind.

Ein physischer Datenträger ist für die Erstellung eines Speicherpools verfügbar, wenn die CanPool-Eigenschaft des MSFT_PhysicalDisk-ObjektsTRUE ist.

Die Erstellung eines Speicherpools ist nur verfügbar, wenn die SupportsStoragePoolCreation-Eigenschaft des MSFT_StorageSubSystem Objekts des Speichersubsystems TRUE ist.

Syntax

UInt32 CreateStoragePool(
  [in]  String              FriendlyName,
  [in]  UInt16              Usage,
  [in]  String              OtherUsageDescription,
  [in]  String              PhysicalDisks[],
  [in]  String              ResiliencySettingNameDefault,
  [in]  UInt16              ProvisioningTypeDefault,
  [in]  UInt64              LogicalSectorSizeDefault,
  [in]  Boolean             EnclosureAwareDefault,
  [in]  UInt64              WriteCacheSizeDefault,
  [in]  Boolean             AutoWriteCacheSize,
  [in]  Boolean             RunAsJob,
  [out] String              CreatedStoragePool,
  [out] MSFT_StorageJob REF CreatedStorageJob,
  [out] String              ExtendedStatus
);

Parameter

FriendlyName [in]

Gibt den Anzeigenamen für den neuen Speicherpool an.

Anzeigenamen sollen beschreibend sein, müssen aber nicht eindeutig sein. Beachten Sie, dass einige Speichersubsysteme das Festlegen eines Anzeigenamens während der Poolerstellung nicht zulassen.

Wenn dies von einem Subsystem nicht unterstützt wird, sollte die Erstellung des Speicherpools weiterhin erfolgreich sein. Dem Pool ist jedoch möglicherweise ein anderer Name zugewiesen.

Dieser Parameter ist erforderlich und darf nicht NULL sein.

Verwendung [in]

Gibt die beabsichtigte Verwendung für den Speicherpool an.

Sie können eine vordefinierte Beschreibung oder eine benutzerdefinierte Beschreibung angeben. Um eine vordefinierte Beschreibung anzugeben, verwenden Sie einen anderen Wert als Other.

Um eine benutzerdefinierte Beschreibung anzugeben, verwenden Sie Other , und geben Sie einen Wert ohne NULL für den OtherUsageDescription-Parameter an.

Sonstiges (1)

Uneingeschränkt (2)

Reserviert für ComputerSystem (der Blockserver) (3)

Reserviert als Deltareplikatcontainer (4)

Reserviert für Migration Services (5)

Reserviert für lokale Replikationsdienste (6)

Reserviert für Remotereplikationsdienste (7)

Reserviert für Sparing (8)

OtherUsageDescription [in]

Ermöglicht es einem Benutzer, einen benutzerdefinierten Verwendungstyp für das neue MSFT_StoragePool-Objekt festzulegen. Dieser Parameter kann nur angegeben werden, wenn der Usage-Parameter auf Other festgelegt ist.

PhysicalDisks [in]

Ein Array von Zeichenfolgen, von denen jede eine eingebettete instance der MSFT_PhysicalDisk-Klasse enthält.

Dieser Parameter wird verwendet, um ein Array von MSFT_PhysicalDisk-Objekten anzugeben, die als Sicherungsdatenspeicher für den neu erstellten Speicherpool verwendet werden. Die physischen Datenträger müssen aus einem ursprünglichen Pool in dem Subsystem stammen, in dem Sie diesen Pool erstellen. Alle physischen Datenträger müssen aus demselben ursprünglichen Pool stammen.

Dieser Parameter ist erforderlich und darf nicht NULL sein.

ResiliencySettingNameDefault [in]

Die gewünschte Resilienzeinstellung, die standardmäßig beim Erstellen eines neuen virtuellen Datenträgers in diesem Speicherpool verwendet werden soll. Wenn die SupportsMultipleResiliencySettingsPerStoragePool-Eigenschaft des Subsystems auf FALSE festgelegt ist, fungiert dieser Parameter auch als Hinweis an den Speicherverwaltungsanbieter, für den die Resilienzeinstellung von diesem Speicherpool geerbt werden soll. Wenn kein Wert angegeben wird, ist der Speicherverwaltungsanbieter dafür verantwortlich, die am besten geeignete Resilienzeinstellung auszuwählen.

ProvisioningTypeDefault [in]

Der gewünschte Bereitstellungstyp, der standardmäßig beim Erstellen eines neuen virtuellen Datenträgers in diesem Speicherpool verwendet werden soll. Wenn dieser Parameter 0 ist, wird der Standardbereitstellungstyp vom ursprünglichen Pool geerbt.

Dünn (1)

Behoben (2)

LogicalSectorSizeDefault [in]

Die standardmäßige logische Sektorgröße in Bytes. Dies ist nützlich, wenn ein Speicherpool eine Mischung aus emulierten 512-Byte- und nativen 4K-Byte- oder 512-Byte-nativen physischen Datenträgern enthalten kann.

EnclosureAwareDefault [in]

Die Standardzuordnungsrichtlinie für virtuelle Datenträger, die in einem gehäusefähigen Speicherpool erstellt werden. Beispiel: Ein Subsystem mit Enclosure Awareness kann jede Datenkopie des virtuellen Datenträgers über mehrere physische Gehäuse hinweg verteilen, damit jedes Gehäuse eine vollständige Datenkopie des virtuellen Datenträgers enthält.

WriteCacheSizeDefault [in]

Die Standardgröße des Schreibcaches für die Erstellung virtueller Datenträger.

AutoWriteCacheSize [in]

Wenn TRUE, sollte der Anbieter die Cachegröße für automatische Schreibvorgänge verwenden.

RunAsJob [in]

Bei TRUE verwendet diese Methode den Parameter CreatedStorageJob , wenn die Anforderung lange dauert. Wenn ein Speicherauftrag zum Nachverfolgen des Vorgangs erstellt wurde, gibt diese Methode Methodenparameter Überprüft – Auftrag gestartet zurück.

Hinweis

Selbst wenn RunAsJobTRUE ist, kann diese Methode trotzdem ein Ergebnis zurückgeben, wenn sie in ausreichender Zeit abgeschlossen ist.

Wenn FALSE oder NULL, folgt diese Methode dem standardmäßigen asynchronen WMI-Verhalten, das von der Clientmethode für den Aufruf bestimmt wird. Mit anderen Worten, es ist synchron, sofern nicht anders angefordert.

CreatedStoragePool [out]

Wenn der Speicherpool erfolgreich erstellt wurde, empfängt dieser Parameter eine Zeichenfolge, die ein eingebettetes MSFT_StoragePool -Objekt enthält.

CreatedStorageJob [out]

Wenn RunAsJob auf TRUE festgelegt ist und die Ausführung dieser Methode sehr lange dauert, empfängt dieser Parameter einen Verweis auf das Speicherauftragsobjekt, das zum Nachverfolgen des lang andauernden Vorgangs verwendet wird.

ExtendedStatus [out]

Eine Zeichenfolge, die ein eingebettetes MSFT_StorageExtendedStatus -Objekt enthält.

Mit diesem Parameter kann der Speicheranbieter erweiterte (implementierungsspezifische) Fehlerinformationen zurückgeben.

Rückgabewert

Erfolg (0)

Nicht unterstützt (1)

Nicht angegebener Fehler (2)

Timeout (3)

Fehler (4)

Ungültiger Parameter (5)

Objekt nicht gefunden (8)

Methodenparameter überprüft – Auftrag gestartet (4096)

Zugriff verweigert (40001)

Es sind nicht genügend Ressourcen vorhanden, um den Vorgang abzuschließen. (40002)

Cache veraltet (40003)

Ein unerwarteter E/A-Fehler ist aufgetreten (40004)

Die Anforderung ist aufgrund eines schwerwiegenden Gerätehardwarefehlers fehlgeschlagen. (40007)

Es kann keine Verbindung mit dem Speicheranbieter hergestellt werden. (46000)

Der Speicheranbieter kann keine Verbindung mit dem Speichersubsystem herstellen. (46001)

Das Failoverclustering konnte für dieses Speicherobjekt nicht aktiviert werden. (46008)

Es ist keine Resilienzeinstellung mit diesem Namen vorhanden. (49000)

Der Wert für WriteCacheSize liegt außerhalb des unterstützten Wertebereichs. (50005)

Einer der angegebenen physischen Datenträger wird von diesem Vorgang nicht unterstützt. (51000)

Es wurden nicht genügend physische Datenträger angegeben, um den Vorgang erfolgreich abzuschließen. (51001)

Einer der angegebenen physischen Datenträger wird bereits verwendet. (51002)

Einer der angegebenen physischen Datenträger verwendet eine Sektorgröße, die von diesem Speicherpool nicht unterstützt wird. (51003)

Mindestens ein physischer Datenträger ist nicht mit den Knoten verbunden, auf denen der Pool erstellt wird. (51005)

Hinweise

Subsysteme, die keine Speicherpools unterstützen, sollten diese Methode wie folgt implementieren:

Subsysteme, die Speicherpools unterstützen, aber die Auswahl des Speicherpools (Administratorauswahl des Pools, in dem der virtuelle Datenträger erstellt wird), das Erstellen, Ändern oder Löschen nicht zulassen, sollten diese Methode wie folgt implementieren:

Subsysteme, die Die Auswahl von Speicherpools und Speicherpools unterstützen, aber das Erstellen, Ändern oder Löschen von Speicherpools nicht unterstützen, sollten diese Methode wie folgt implementieren:

Subsysteme, die die Auswahl von Speicherpools und Speicherpools unterstützen und auch das Erstellen, Ändern oder Löschen von Speicherpools unterstützen, sollten diese Methode wie folgt implementieren:

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [nur Desktop-Apps]
Namespace Stamm\Microsoft\Windows\Storage
MOF Storagewmi.mof

Weitere Informationen

MSFT_StorageSubSystem