CreateReplicationRelationship-Methode der MSFT_StorageSubSystem-Klasse

Artikel
03/08/2023

Erstellt zwei Replikationsgruppen und eine Replikationsbeziehung zwischen ihnen. Diese Methode erfordert, dass das Subsystem die vollständig ermittelte Replikation unterstützt.

Syntax

UInt32 CreateReplicationRelationship(
  [in]  String              FriendlyName,
  [in]  Uint16              SyncType,
  [in]  String              TargetStorageSubsystem,
  [in]  String              SourceReplicationGroupFriendlyName,
  [in]  String              SourceReplicationGroupDescription,
  [in]  String              SourceStorageElements[],
  [in]  String              SourceGroupSettings,
  [in]  String              TargetReplicationGroupFriendlyName,
  [in]  String              TargetReplicationGroupDescription,
  [in]  String              TargetStorageElements[],
  [in]  String              TargetStoragePool,
  [in]  String              TargetStoragePools[],
  [in]  String              TargetGroupSettings,
  [in]  UInt16              RecoveryPointObjective,
  [out] String              SourceGroup,
  [out] String              TargetGroup,
  [out] String              CreatedReplicaPeer,
  [out] MSFT_StorageJob REF CreatedStorageJob,
  [out] String              ExtendedStatus
);

Parameter

FriendlyName [in]

Ein benutzerrelevanter Name für die Beziehung zwischen der Quelle und der Zielgruppe oder zwischen einem Quellelement und einer Zielgruppe (d.a. 1:n). Bei NULL weist die Implementierung einen Namen zu. Wenn für die einzelnen Zielelemente ein ElementName erforderlich ist, erstellt die Implementierung einen entsprechenden ElementName mithilfe von RelationshipName. Beispiel : RelationshipName als Präfix gefolgt von einer "_n"-Sequenznummer, wobei n eine Zahl ist, die mit 1 beginnt.

SyncType [in]

Beschreibt den Kopiertyp, der erstellt wird.

DMTF Reserviert (..)

Spiegelung (6)

Momentaufnahme (7)

Klonen (8)

TokenizedClone (9)

DMTF Reserviert (..)

Anbieterspezifisch (0x8000..)

TargetStorageSubsystem [in]

Eine Zeichenfolge, die ein eingebettetes MSFT_ReplicaPeer -Objekt enthält. Dadurch kann der Benutzer das Replikatzielsubsystem angeben, wenn er eine Beziehung mit einem anderen Subsystem aufbaut.

SourceReplicationGroupFriendlyName [in]

Der Name der zu erstellenden Quellreplikationsgruppe.

SourceReplicationGroupDescription [in]

Eine Beschreibung des Zwecks der Quellreplikationsgruppe.

SourceStorageElements [in]

Gibt ein Array von Zeichenfolgen an, die eingebettete MSFT_StorageObject-Objekte enthalten. Dies ist eine geordnete Liste von Speicherobjekten, die Teil der Quellreplikationsgruppe sein sollen.

SourceGroupSettings [in]

Eine Zeichenfolge, die ein eingebettetes MSFT_ReplicationSettings -Objekt enthält, das auf die Quellreplikationsgruppe angewendet werden soll.

TargetReplicationGroupFriendlyName [in]

Der Name der zu erstellenden Zielreplikationsgruppe.

TargetReplicationGroupDescription [in]

Eine Beschreibung des Zwecks der Zielreplikationsgruppe.

TargetStorageElements [in]

Gibt ein Array von Zeichenfolgen an, die eingebettete MSFT_StorageObject-Objekte enthalten. Dies ist eine geordnete Liste von Speicherobjekten, die Teil der Zielreplikationsgruppe sein sollen.

TargetStoragePool [in]

Eine Zeichenfolge, die ein eingebettetes MSFT_StoragePool -Objekt enthält. Dies ist ein Speicherpool auf dem Ziel, der als Quelle zum Erstellen der erforderlichen TargetStorageElements verwendet werden soll. Dieser Parameter kann anstelle von TargetStorageElements angegeben werden.

TargetStoragePools [in]

Ein Array von Zeichenfolgen, die eingebettete MSFT_StoragePool-Objekte enthalten. Der zugrunde liegende Speicher für die Zielelemente (die Replikate) wird bei Angabe aus TargetStoragePool gezeichnet. Andernfalls ist die Zuordnung implementierungsspezifisch. Wenn Zielelemente angegeben werden, muss dieser Parameter NULL sein. Wenn TargetStoragePools angegeben wird, muss TargetStoragePoolNULL sein.

TargetGroupSettings [in]

Eine Zeichenfolge, die ein eingebettetes MSFT_ReplicationSettings -Objekt enthält, das auf die Zielreplikationsgruppe angewendet werden soll.

RecoveryPointObjective [in]

Gibt das maximale Intervall an, in dem Daten verloren gehen können. Für synchrone Kopiervorgänge ist RecoveryPointObjective 0. Bei asynchronen Kopiervorgängen stellt RecoveryPointObjective das Intervall seit der letzten Übertragung von Daten an das Zielelement dar.

SourceGroup [out]

Wenn die Replikationsgruppen und die Beziehung erfolgreich erstellt wurden, empfängt dieser Parameter eine Zeichenfolge, die ein eingebettetes MSFT_ReplicationGroup -Objekt enthält, das die Quellreplikationsgruppe darstellt.

Zielgruppe [out]

Wenn die Replikationsgruppen und die Beziehung erfolgreich erstellt wurden, empfängt dieser Parameter eine Zeichenfolge, die ein eingebettetes MSFT_ReplicationGroup Objekt enthält, das die Zielreplikationsgruppe darstellt.

CreatedReplicaPeer [out]

Wenn die Replikationsgruppen und die Beziehung erfolgreich erstellt wurden, empfängt dieser Parameter eine Zeichenfolge, die ein eingebettetes MSFT_ReplicaPeer -Objekt enthält, das den Replikatpeer für die Zielreplikationsgruppe darstellt.

CreatedStorageJob [out]

Gibt einen Verweis auf das Speicherauftragsobjekt zurück, das zum Nachverfolgen des vorgangs mit langer Ausführung 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)

Der Vorgang wird nicht unterstützt, während der Cluster aktualisiert wird. (40009)

Anforderungen

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

Weitere Informationen

MSFT_StorageSubSystem

Freigeben über