CreateReplica-Methode der MSFT_ReplicationGroup-Klasse
Erstellt eine Replikationsbeziehung zwischen Replikationsgruppen.
Syntax
UInt32 CreateReplica(
[in] String FriendlyName,
[in] String TargetStorageSubsystem,
[in] String TargetGroupObjectId,
[in, optional] String TargetStoragePoolObjectId,
[in, optional] UInt32 RecoveryPointObjective,
[in] String ReplicationSettings,
[in] UInt16 SyncType,
[out] String CreatedReplicaPeer,
[out] MSFT_StorageJob REF CreatedStorageJob,
[out] String ExtendedStatus
);
Parameter
FriendlyName [in]
Ein endbenutzerrelevanter Name für das zu erstellende Element. Wenn NULL, kann ein vom System bereitgestellter Standardname verwendet werden. Der Wert wird in der FriendlyName-Eigenschaft für das erstellte Element gespeichert.
TargetStorageSubsystem [in]
Eine Zeichenfolge, die ein eingebettetes MSFT_ReplicaPeer -Objekt enthält, das das Replikatzielsubsystem angibt.
TargetGroupObjectId [in]
Gibt das Replikationsgruppenziel auf dem Zielcomputer an.
TargetStoragePoolObjectId [in, optional]
Ein Speicherpool auf dem Ziel, der als Quelle zum Erstellen der erforderlichen Zielspeicherelemente verwendet werden soll. Dieser Parameter wird ignoriert, wenn die Zielgruppe Elemente enthält.
RecoveryPointObjective [in, optional]
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.
ReplicationSettings [in]
Eine Zeichenfolge, die ein eingebettetes MSFT_ReplicationSettings -Objekt enthält, das angewendet werden soll.
SyncType [in]
Der Kopiertyp, der erstellt wird. Einer der folgenden Werte:
| Wert | Bedeutung |
|---|---|
| DMTF Reserviert . | Dieser Wert ist für die Verwendung durch das System reserviert. |
| Spiegel 6 | Erstellen und verwalten Sie eine Kopie der Quelle. |
| Momentaufnahme 7 | Erstellen Sie eine Volumeschattenkopie der Quelle. |
| Klonen 8 | Erstellen Sie eine vollständige Point-in-Time-Kopie der Quelle. |
| TokenizedClone 9 | Erstellen Sie eine tokenisierte Point-in-Time-Kopie der Quelle. |
| DMTF Reserviert . | Dieser Wert ist für die Verwendung durch das System reserviert. |
| Herstellerspezifische 0x8000.. | Diese Werte sind für Anbieter reserviert. |
CreatedReplicaPeer [out]
Dieser Parameter empfängt eine Zeichenfolge, die ein eingebettetes MSFT_Synchronized -Objekt enthält, das die Zuordnung zwischen den Replikationsgruppen 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 |
| Header | Adojet.h |
| MOF | Storagewmi.mof |