CreateReplicationRelationship-Methode der MSFT_StorageSubSystem-Klasse
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 |