Méthode CreateReplicationRelationship de la classe MSFT_StorageSubSystem
Crée deux groupes de réplication et une relation de réplication entre eux. Cette méthode nécessite que le sous-système prend en charge la réplication entièrement découverte.
Syntaxe
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
);
Paramètres
FriendlyName [in]
Nom pertinent pour l’utilisateur pour la relation entre les groupes source et cible, ou entre un élément source et un groupe cible (c’est-à-dire un-à-plusieurs). Si la valeur est NULL, l’implémentation attribue un nom. Si les éléments cibles individuels nécessitent un ElementName, l’implémentation construit un ElementName approprié à l’aide de RelationshipName ; par exemple, RelationshipName en tant que préfixe suivi d’un numéro de séquence « _n », où n est un nombre commençant par 1.
SyncType [in]
Décrit le type de copie qui sera effectuée.
DMTF réservé (..)
Miroir (6)
Instantané (7)
Cloner (8)
TokenizedClone (9)
DMTF réservé (..)
Propre au fournisseur (0x8000..)
TargetStorageSubsystem [in]
Chaîne qui contient un objet MSFT_ReplicaPeer incorporé. Cela permet à l’utilisateur de spécifier le réplica sous-système cible lors de la configuration d’une relation avec un autre sous-système.
SourceReplicationGroupFriendlyName [in]
Nom du groupe de réplication source à créer.
SourceReplicationGroupDescription [in]
Description de l’objectif du groupe de réplication source.
SourceStorageElements [in]
Spécifie un tableau de chaînes qui contiennent des objets MSFT_StorageObject incorporés. Il s’agit d’une liste ordonnée d’objets de stockage qui doivent faire partie du groupe de réplication source.
SourceGroupSettings [in]
Chaîne qui contient un objet incorporé MSFT_ReplicationSettings à appliquer au groupe de réplication source.
TargetReplicationGroupFriendlyName [in]
Nom du groupe de réplication cible à créer.
TargetReplicationGroupDescription [in]
Description de l’objectif du groupe de réplication cible.
TargetStorageElements [in]
Spécifie un tableau de chaînes qui contiennent des objets MSFT_StorageObject incorporés. Il s’agit d’une liste ordonnée d’objets de stockage qui doivent faire partie du groupe de réplication cible.
TargetStoragePool [in]
Chaîne qui contient un objet MSFT_StoragePool incorporé. Il s’agit d’un pool de stockage sur la cible à utiliser comme source pour créer les éléments TargetStorageElements nécessaires. Ce paramètre peut être spécifié au lieu de TargetStorageElements.
TargetStoragePools [in]
Tableau de chaînes contenant des objets MSFT_StoragePool incorporés. Le stockage sous-jacent pour les éléments cibles (les réplicas) sera extrait de TargetStoragePool si spécifié. Sinon, l’allocation est spécifique à l’implémentation. Si des éléments cibles sont fournis, ce paramètre doit avoir la valeur NULL. Si TargetStoragePools est fourni, TargetStoragePool doit avoir la valeur NULL.
TargetGroupSettings [in]
Chaîne qui contient un objet incorporé MSFT_ReplicationSettings à appliquer au groupe de réplication cible.
RecoveryPointObjective [in]
Indique l’intervalle maximal pendant lequel les données peuvent être perdues. Pour les opérations de copie synchrone, RecoveryPointObjective est 0. Pour les opérations de copie asynchrone , RecoveryPointObjective représente l’intervalle depuis la dernière transmission de données à l’élément cible.
SourceGroup [out]
Si les groupes de réplication et la relation sont créés correctement, ce paramètre reçoit une chaîne qui contient un objet MSFT_ReplicationGroup incorporé représentant le groupe de réplication source.
TargetGroup [out]
Si les groupes de réplication et la relation sont créés avec succès, ce paramètre reçoit une chaîne qui contient un objet MSFT_ReplicationGroup incorporé représentant le groupe de réplication cible.
CreatedReplicaPeer [out]
Si les groupes de réplication et la relation sont créés avec succès, ce paramètre reçoit une chaîne qui contient un objet MSFT_ReplicaPeer incorporé représentant l’homologue réplica pour le groupe de réplication cible.
CreatedStorageJob [out]
Retourne une référence à l’objet de travail de stockage utilisé pour suivre l’opération de longue durée.
ExtendedStatus [out]
Chaîne qui contient un objet MSFT_StorageExtendedStatus incorporé.
Ce paramètre permet au fournisseur de stockage de retourner des informations d’erreur étendues (spécifiques à l’implémentation).
Valeur retournée
Réussite (0)
Non pris en charge (1)
Erreur non spécifiée (2)
Délai d’expiration (3)
Échec (4)
Paramètre non valide (5)
Objet introuvable (8)
Paramètres de méthode vérifiés - Travail démarré (4096)
Accès refusé (40001)
Il n’y a pas assez de ressources pour terminer l’opération. (40002)
Cache obsolète (40003)
L’opération n’est pas prise en charge pendant la mise à niveau du cluster. (40009)
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows 10 (applications de bureau uniquement) |
Serveur minimal pris en charge | Windows Server 2016 (applications de bureau uniquement) |
Espace de noms | Root\Microsoft\Windows\Storage |
MOF | Storagewmi.mof |