Msvm_ReplicationSettingData classe

Article
06/12/2023

Représente les paramètres spécifiques à la réplication pour une machine virtuelle. Le client transmet une instance de cette classe à Msvm_ReplicationService.CreateReplicationRelationRelationship pour créer une relation de réplication. Le client ne peut pas modifier directement les valeurs de l’une des propriétés de cette classe ; elle doit appeler la méthode Msvm_ReplicationService.ModifyReplicationSettings pour modifier les valeurs. Chaque relation de réplication a une seule instance de paramètres.

La syntaxe suivante est un code MOF (Managed Object Format) simplifié et inclut toutes les propriétés héritées.

Syntaxe

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_ReplicationSettingData : CIM_VirtualSystemSettingData
{
  string   InstanceID = "Microsoft:Virtual Machine GUID\HVR";
  string   Caption = "Replication Settings";
  string   Description = "Virtual Machine Replication Settings Data";
  string   ElementName;
  string   VirtualSystemIdentifier;
  string   VirtualSystemType = "Microsoft:Hyper-V:Replica";
  string   Notes[];
  datetime CreationTime;
  string   ConfigurationID;
  string   ConfigurationDataRoot;
  string   ConfigurationFile;
  string   SnapshotDataRoot;
  string   SuspendDataRoot;
  string   SwapFileDataRoot;
  string   LogDataRoot;
  uint16   AutomaticStartupAction;
  datetime AutomaticStartupActionDelay;
  uint16   AutomaticStartupActionSequenceNumber;
  uint16   AutomaticShutdownAction;
  uint16   AutomaticRecoveryAction;
  string   RecoveryFile;
  uint16   AuthenticationType;
  string   CertificateThumbPrint;
  string   RootCertificateThumbPrint;
  boolean  CompressionEnabled;
  boolean  BypassProxyServer;
  string   RecoveryConnectionPoint;
  string   RecoveryHostSystem;
  string   PrimaryConnectionPoint;
  string   PrimaryHostSystem;
  uint16   RecoveryServerPortNumber = 0;
  boolean  ReplicateHostKvpItems = True;
  uint16   ApplicationConsistentSnapshotInterval;
  uint16   RecoveryHistory = 0;
  string   IncludedDisks[];
  boolean  AutoResynchronizeEnabled = False;
  datetime AutoResynchronizeIntervalStart = 00000000183000.000000:000;
  datetime AutoResynchronizeIntervalEnd = 00000000060000.000000:000;
  boolean  EnableWriteOrderPreservationAcrossDisks;
  string   ReplicationProvider;
  string   AdditionalSettings;
  uint16   ReplicationInterval = 300;
};

Membres

La classe Msvm_ReplicationSettingData a les types de membres suivants :

Propriétés

Propriétés

La classe Msvm_ReplicationSettingData possède ces propriétés.

AdditionalSettings

Type de données : chaîne
Type d'accès : Lecture seule

Paramètres de réplication supplémentaires que le fournisseur de point de terminaison peut utiliser.

Windows 8.1 : cette valeur n’est pas prise en charge tant qu’Windows 8.1 et Windows Server 2012 R2.

ApplicationConsistentSnapshotInterval

Type de données : uint16
Type d'accès : Lecture seule

Intervalle de temps entre les instantanés cohérents de l’application, spécifié en heures. Les valeurs valides sont comprises entre 1 heure et 12 heures.

AuthenticationType

Type de données : uint16
Type d'accès : Lecture seule

Définissez le mode d’authentification utilisé pour se connecter pour récupérer le serveur.

Authentification Kerberos (1)

Authentification Kerberos.

Authentification basée sur les certificats (2)

Authentification basée sur les certificats.

AutomaticRecoveryAction

Type de données : uint16
Type d'accès : Lecture seule

Non utilisé.

Cette propriété est héritée de CIM_VirtualSystemSettingData.

AutomaticShutdownAction

Type de données : uint16
Type d'accès : Lecture seule

Non utilisé.

Cette propriété est héritée de CIM_VirtualSystemSettingData.

AutomaticStartupAction

Type de données : uint16
Type d'accès : Lecture seule

Non utilisé.

Cette propriété est héritée de CIM_VirtualSystemSettingData.

AutomaticStartupActionDelay

Type de données : datetime
Type d'accès : Lecture seule

Délai avant le démarrage automatique de la machine virtuelle. Cette propriété est héritée de CIM_VirtualSystemSettingData, mais elle n’est pas utilisée.

AutomaticStartupActionSequenceNumber

Type de données : uint16
Type d'accès : Lecture seule

Nombre qui indique la séquence relative d’activation de la machine virtuelle au démarrage du système hôte. Cette propriété est héritée de CIM_VirtualSystemSettingData, mais elle n’est pas utilisée.

AutoResynchronizeEnabled

Type de données : booléen
Type d'accès : Lecture seule

Spécifie si les opérations de resynchronisation sont automatiquement déclenchées lorsqu’une erreur de réplication se produit en raison de pannes d’alimentation et de matériel. Les opérations de resynchronisation sont déclenchées uniquement lorsque l’échec se produit entre les heures spécifiées par les propriétés AutoResynchronizeIntervalStart et AutoResynchronizeIntervalEnd .

La valeur par défaut est False.

AutoResynchronizeIntervalEnd

Type de données : datetime
Type d'accès : Lecture seule

Spécifie l’heure de fin des opérations de resynchronisation automatique à déclencher. Cette valeur est en heure locale. La valeur par défaut est 06:00 (6:00 A.M.).

Les opérations de resynchronisation sont déclenchées uniquement lorsque l’échec se produit entre les heures spécifiées par les propriétés AutoResynchronizeIntervalStart et AutoResynchronizeIntervalEnd .

Les opérations de resynchronisation peuvent également être planifiées afin qu’elles soient déclenchées pendant l’intervalle suivant.

AutoResynchronizeIntervalStart

Type de données : datetime
Type d'accès : Lecture seule

Spécifie l’heure de début des opérations de resynchronisation automatique à déclencher. Cette valeur est en heure locale. La valeur par défaut est 18:30 (18:30).

Les opérations de resynchronisation peuvent également être planifiées afin qu’elles soient déclenchées pendant l’intervalle suivant.

BypassProxyServer

Type de données : booléen
Type d'accès : Lecture seule

Spécifie si le serveur proxy doit être contourné lors de la connexion à un serveur de récupération.

Caption

Type de données : chaîne
Type d'accès : Lecture seule

Brève description de l’objet. Cette propriété est héritée de CIM_ManagedElement et est toujours définie sur « Paramètres de réplication ».

CertificateThumbPrint

Type de données : chaîne
Type d'accès : Lecture seule
Qualificateurs : Maxlen (128)

Empreinte numérique de certificat à utiliser lorsque la propriété AuthenticationType est une authentification basée sur un certificat.

CompressionEnabled

Type de données : booléen
Type d'accès : Lecture seule

Spécifie si les données de réplication seront compressées lors de leur envoi au serveur de récupération.

ConfigurationDataRoot

Type de données : chaîne
Type d'accès : Lecture seule

Non utilisé.

Cette propriété est héritée de CIM_VirtualSystemSettingData.

ConfigurationFile

Type de données : chaîne
Type d'accès : Lecture seule

Chemin d’accès relatif et nom de fichier d’un fichier où sont stockées des informations sur la configuration de la machine virtuelle. Ce chemin est relatif à la propriété ConfigurationDataRoot . Cette propriété est héritée de CIM_VirtualSystemSettingData, mais elle n’est pas utilisée.

ConfigurationID

Type de données : chaîne
Type d'accès : Lecture seule

Identificateur unique de la configuration de la machine virtuelle. Cette propriété est héritée de CIM_VirtualSystemSettingData, mais elle n’est pas utilisée.

CreationTime

Type de données : datetime
Type d'accès : Lecture seule

Date et heure auxquelles les paramètres de la machine virtuelle ont été créés. Si cet objet représente les paramètres actuels de la machine virtuelle, cette valeur correspond à l’heure à laquelle le système a été créé. Si cet objet représente les paramètres instantané de la machine virtuelle, cette valeur correspond à l’heure à laquelle le instantané a été pris. Cette propriété est héritée de CIM_VirtualSystemSettingData.

Il s’agit d’une propriété en lecture seule, mais elle peut être modifiée à l’aide de la méthode ModifySystemSettings de la classe Msvm_VirtualSystemManagementService .

Cette propriété est héritée de CIM_VirtualSystemSettingData.

Description

Type de données : chaîne
Type d'accès : Lecture seule

Description de l'objet . Cette propriété est héritée de CIM_ManagedElement, et elle est toujours définie sur « Données des paramètres de réplication de machine virtuelle ».

ElementName

Type de données : chaîne
Type d'accès : Lecture seule

Nom d’affichage de l’objet. Cette propriété est héritée de CIM_VirtualSystemSettingData et est définie sur le nom d’affichage de la machine virtuelle.

EnableWriteOrderPreservationAcrossDisks

Type de données : booléen
Type d'accès : Lecture seule
Qualificateurs : déprécié (« Aucune valeur »)

Spécifie si tous les disques durs virtuels répliqués pour la machine virtuelle sont répliqués au même point dans le temps. Cela garantit que la réplication respecte l’ordre d’écriture des applications dans la machine virtuelle.

Windows 8.1 : à compter de Windows 8.1 et Windows Server 2012 R2, cette propriété est dépréciée et toujours définie sur TRUE.

IncludedDisks

Type de données : tableau de chaînes
Type d'accès : Lecture seule
Qualificateurs : HyperVEmbeddedInstance (« CIM_StorageAllocationSettingData »), ArrayType (« Indexed »)

Liste des disques durs virtuels (VHD) attachés au système qui seront répliqués par le moteur de réplication. Il s’agit d’un tableau de chaînes, chacune contenant l’InstanceID du Msvm_StorageAllocationSettingData qui représente le disque dur virtuel.

InstanceID

Type de données : chaîne
Type d'accès : Lecture seule
Qualificateurs : clé

Identifie de manière unique un instance de cette classe. Cette propriété est héritée de CIM_SettingData. Par Windows 8, il est toujours défini sur « Microsoft:Virtual Machine GUID\HVR ». Pour Windows 8.1, il est défini sur « Microsoft:Virtual Machine GUID\HVR\<0/1> ». Dans la valeur Windows 8.1, 0 indique principal et 1 indique la réplication étendue. Pour plus d’informations sur la réplication étendue, consultez Msvm_ReplicationRelationship.

LogDataRoot

Type de données : chaîne
Type d'accès : Lecture seule

Chemin d’accès d’un répertoire où sont stockées les informations de journal de la machine virtuelle. Cette propriété est héritée de CIM_VirtualSystemSettingData, mais elle n’est pas utilisée.

Remarques

Type de données : tableau de chaînes
Type d'accès : Lecture seule

Non utilisé et ne peut pas être défini.

Cette propriété est héritée de CIM_VirtualSystemSettingData.

PrimaryConnectionPoint

Type de données : chaîne
Type d'accès : Lecture seule
Qualificateurs : Maxlen (256)

Nom du point de connexion principal. Dans le cas d’un cluster principal, il s’agit du nom du répartiteur CAP. Dans le cas d’un serveur principal autonome, il s’agit du nom du système hôte.

PrimaryHostSystem

Type de données : chaîne
Type d'accès : Lecture seule
Qualificateurs : Maxlen (256)

Nom de domaine complet du système hôte principal qui héberge la machine virtuelle.

RecoveryConnectionPoint

Type de données : chaîne
Type d'accès : Lecture seule
Qualificateurs : Maxlen (256)

Nom du point de connexion de récupération. Dans le cas d’un cluster de récupération, il s’agit du nom du répartiteur CAP. Dans le cas d’un serveur de récupération autonome, il s’agit du nom du système hôte.

RecoveryFile

Type de données : chaîne
Type d'accès : Lecture seule

Chemin d’accès complet d’un fichier dans lequel sont stockées les informations relatives à la récupération de la machine virtuelle. Cette propriété est héritée de CIM_VirtualSystemSettingData, mais elle n’est pas utilisée.

RecoveryHistory

Type de données : uint16
Type d'accès : Lecture seule

Nombre maximal d’instantanés de récupération qui seront stockés sur le serveur de récupération. Les valeurs valides sont comprises entre 0 et 24.

RecoveryHostSystem

Type de données : chaîne
Type d'accès : Lecture seule
Qualificateurs : Maxlen (256)

Nom de domaine complet du système hôte de récupération qui héberge la machine virtuelle.

RecoveryServerPortNumber

Type de données : uint16
Type d'accès : Lecture seule

Numéro de port du serveur de récupération à utiliser lors de l’établissement d’une connexion sécurisée pour la réplication.

ReplicateHostKvpItems

Type de données : booléen
Type d'accès : Lecture seule

Spécifie si les Msvm_KvpExchangeDataItemd’hôte uniquement doivent être répliqués de la machine virtuelle principale vers la machine virtuelle de récupération.

ReplicationInterval

Type de données : uint16
Type d'accès : Lecture seule

Intervalle de réplication d’une relation de réplication en secondes. Les valeurs autorisées sont :

300

900

La valeur par défaut est 300 secondes.

Windows 8.1 : cette valeur n’est pas prise en charge tant qu’Windows 8.1 et Windows Server 2012 R2.

ReplicationProvider

Type de données : chaîne
Type d'accès : Lecture seule

Chemin d’accès au instance de la classe Msvm_ReplicationProvider qui identifie le point de terminaison du fournisseur de réplication.

Windows 8.1 : cette valeur n’est pas prise en charge tant qu’Windows 8.1 et Windows Server 2012 R2.

RootCertificateThumbPrint

Type de données : chaîne
Type d'accès : Lecture seule
Qualificateurs : Maxlen (128)

Empreinte numérique du certificat racine du certificat utilisé lorsque AuthenticationType a la valeur 2 (autorisation basée sur le certificat).

SnapshotDataRoot

Type de données : chaîne
Type d'accès : Lecture seule

Chemin d’accès d’un répertoire où sont stockées les informations sur les instantanés de machine virtuelle. Cette propriété est héritée de CIM_VirtualSystemSettingData, mais elle n’est pas utilisée.

SuspendDataRoot

Type de données : chaîne
Type d'accès : Lecture seule

Chemin d’accès d’un répertoire où sont stockées les informations relatives à la suspension de la machine virtuelle. Cette propriété est héritée de CIM_VirtualSystemSettingData, mais elle n’est pas utilisée.

SwapFileDataRoot

Type de données : chaîne
Type d'accès : Lecture seule

Chemin d’accès d’un répertoire où sont stockés les fichiers d’échange pour la machine virtuelle. Cette propriété est héritée de CIM_VirtualSystemSettingData, mais elle n’est pas utilisée.

VirtualSystemIdentifier

Type de données : chaîne
Type d'accès : Lecture seule

Nom de l’objet CIM_ComputerSystem auquel appartiennent ces données de paramètre. Cette propriété est un remplacement de CIM_VirtualSystemSettingData.

VirtualSystemType

Type de données : chaîne
Type d'accès : Lecture seule

Spécifie le type de machine virtuelle que les données de paramètre représentent. Cette propriété est héritée de CIM_VirtualSystemSettingData et est toujours définie sur « Microsoft:Hyper-V:Replica ».

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Espace de noms	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Voir aussi

CIM_VirtualSystemSettingData
ModifyReplicationSettings

Partager via

Msvm_ReplicationSettingData classe

Syntaxe

Membres

Propriétés

Spécifications

Voir aussi

Commentaires

Ressources supplémentaires