Msvm_ReplicationService-Klasse

Artikel
06/12/2023

Verwaltet die Replikation für einen virtuellen Computer.

Die folgende Syntax ist vereinfachter MOF-Code (Managed Object Format) und enthält alle geerbten Eigenschaften.

Syntax

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_ReplicationService : CIM_Service
{
  string   InstanceID;
  string   Caption = "Hyper-V Replica Service";
  string   Description = "Replication Service";
  string   ElementName;
  datetime InstallDate;
  string   Name = "replicasvc";
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  string   Status = "OK";
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 2;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_ComputerSystem";
  string   SystemName;
  string   CreationClassName = "Msvm_ReplicationService";
  string   PrimaryOwnerName;
  string   PrimaryOwnerContact;
  string   StartMode;
  boolean  Started = True;
};

Member

Die Msvm_ReplicationService-Klasse verfügt über folgende Membertypen:

Methoden
Eigenschaften

Methoden

Die Msvm_ReplicationService-Klasse verfügt über diese Methoden.

Methode	Beschreibung
AddAuthorizationEntry	Fügt einem Server einen Autorisierungseintrag hinzu.
ChangeReplicationModeToPrimary	Ändert die erweiterte Replikationsbeziehung in die primäre Beziehung für einen virtuellen Replikatcomputer. Der virtuelle Replikatcomputer muss sich im Failover-Commit-Zustand befinden. Windows 8.1: Diese Methode wird erst unterstützt, wenn Windows 8.1 und Windows Server 2012 R2 Windows Server 2012.
CommitFailover	Committent die Wiederherstellungs-Momentaufnahme, die die InitiateFailover-Methode für ein Failover verwendet hat.
CreateReplicationRelationship	Erstellt eine neue Replikationsbeziehung für einen virtuellen Computer.
GetReplicationStatistics	Ruft Replikationsstatistiken für einen virtuellen Computer ab.
GetReplicationStatisticsEx	Ruft die Replikationsstatistiken ab, die der angegebenen Replikationsbeziehung des virtuellen Computers zugeordnet sind. Windows 8.1: Diese Methode wird erst unterstützt, wenn Windows 8.1 und Windows Server 2012 R2 Windows Server 2012.
GetSystemCertificates	Ruft die Systemzertifikate auf einem Hostsystem ab.
ImportInitialReplica	Importiert die anfängliche Replikation für einen virtuellen Computer.
InitiateFailback	Initiiert das Failback für einen virtuellen Wiederherstellungscomputer. Das heißt, legt das Failover für den virtuellen Computer auf eine App oder ein absturzkonsistentes Image fest. Windows 8.1: Diese Methode wird erst unterstützt, wenn Windows 8.1 und Windows Server 2012 R2 Windows Server 2012.
InitiateFailover	Initiiert ein Failover für einen virtuellen Computer zu einem Anwendungs- oder Standardreplikationspunktimage.
ModifyAuthorizationEntry	Ändert einen Autorisierungseintrag auf einem Server.
ModifyReplicationSettings	Ändert die Replikationseinstellungen für einen virtuellen Computer.
ModifyServiceSettings	Ändert die Einstellungen für den Hyper-V-Replikatdienst.
RemoveAuthorizationEntry	Entfernt den Autorisierungseintrag von einem Server.
RemoveReplicationRelationship	Entfernt eine Vm-Replikationsbeziehung.
RemoveReplicationRelationshipEx	Entfernt die angegebene Vm-Replikationsbeziehung. Bei einem virtuellen Replikatcomputer kann die primäre Replikation nicht entfernt werden, wenn die erweiterte Replikation aktiviert ist. Windows 8.1: Diese Methode wird erst unterstützt, wenn Windows 8.1 und Windows Server 2012 R2 Windows Server 2012.
RequestStateChange	Fordert eine Zustandsänderung an.
ResetReplicationStatistics	Setzt die Replikationsstatistiken für einen virtuellen Computer zurück.
ResetReplicationStatisticsEx	Setzt Replikationsstatistiken zurück, die der angegebenen Replikationsbeziehung eines virtuellen Computers zugeordnet sind. Windows 8.1: Diese Methode wird erst unterstützt, wenn Windows 8.1 und Windows Server 2012 R2 Windows Server 2012.
Erneutes Synchronisieren.	Führt einen Neusynchronisierungsvorgang auf dem angegebenen virtuellen Computer aus.
ReverseReplicationRelationship	Repliziert einen virtuellen Computer mit Failover zurück auf den primären Server.
RevertFailover	Stellt das aktuelle Failover für einen virtuellen Computer zurück, indem der aktuelle Failoverdatenträger verworfen wird.
SetAuthorizationEntry	Legt den Replikationsautorisierungseintrag für einen virtuellen Computer fest.
SetFailoverNetworkAdapterSettings	Konfiguriert die IP-Einstellungen des Netzwerkadapters, die nach einem Failover auf einen virtuellen Computer angewendet werden sollen.
StartReplication	Startet die Replikation eines virtuellen Computers.
Startservice	Startet den Dienst.
StopService	Beendet den Dienst.
TestReplicaSystem	Erstellt ein neues Replikat eines virtuellen Computers mit dem angegebenen Momentaufnahme zu Testzwecken.
TestReplicationConnection	Überprüft, ob die Replikation vom aktuellen Hostsystem zum angegebenen Wiederherstellungssystem aktiviert werden kann.

Eigenschaften

Die Msvm_ReplicationService-Klasse verfügt über diese Eigenschaften.

AvailableRequestedStates

Datentyp: uint16-Array
Zugriffstyp: Schreibgeschützt

Gibt die möglichen Werte für den RequestedState-Parameter an. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt und immer auf Null festgelegt.

Caption

Datentyp: string
Zugriffstyp: Schreibgeschützt

Eine kurze Beschreibung des Objekts. Diese Eigenschaft wird von CIM_ManagedElement geerbt und ist immer auf "Hyper-V-Replikatdienst" festgelegt.

CommunicationStatus

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Gibt die Fähigkeit der Instrumentierung an, mit dem zugrunde liegenden verwalteten Element zu kommunizieren. Ein Null-Wert gibt an, dass diese Eigenschaft nicht implementiert ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Unbekannt (0)
Nicht verfügbar (1)
Kommunikation OK (2)
Verlorene Kommunikation (3)
Kein Kontakt (4)
DMTF Reserviert (..)
Vendor Reserved (0x8000.. )

CreationClassName

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Key, MaxLen ( 256 )

Der Name der Klasse oder Unterklasse, die bei der Erstellung eines instance verwendet wird. Diese Eigenschaft wird von CIM_Service geerbt und immer auf "Msvm_ReplicationService" festgelegt.

Beschreibung

Datentyp: string
Zugriffstyp: Schreibgeschützt

Eine Beschreibung des -Objekts. Diese Eigenschaft wird von CIM_ManagedElement geerbt und ist immer auf "Replikationsdienst" festgelegt.

DetailedStatus

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Ergänzt die PrimaryStatus-Eigenschaft mit zusätzlichen status Details. Ein Null-Wert gibt an, dass diese Eigenschaft nicht implementiert ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Nicht verfügbar (0)
Keine zusätzlichen Informationen (1)
Gestresst (2)
Vorhersagefehler (3)
Nicht wiederherstellbarer Fehler (4)
Unterstützende Entität im Fehler (5)
DMTF Reserviert (..)
Vendor Reserved (0x8000.. )

ElementName

Datentyp: string
Zugriffstyp: Schreibgeschützt

Ein Anzeigename für das Objekt. Diese Eigenschaft wird von CIM_ManagedElement geerbt.

EnabledDefault

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Die Standard- oder Startkonfiguration eines Administrators für den aktivierten Status eines Elements. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt und ist immer auf 2 (Aktiviert) festgelegt.

Wert	Bedeutung
2	Aktiviert

EnabledState

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Der aktivierte und deaktivierte Status eines Elements. Es kann auch die Übergänge zwischen diesen angeforderten Zuständen angeben. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt und ist immer auf 2 (Aktiviert) festgelegt.

Wert	Bedeutung
2	Aktiviert

HealthState

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Die aktuelle Integrität des Elements. Dieses Attribut drückt die Integrität dieses Elements aus, aber nicht unbedingt die seiner Unterkomponenten. Die möglichen Werte sind 0 bis 30, wobei 5 bedeutet, dass das Element vollständig fehlerfrei ist und 30 bedeutet, dass das Element vollständig nicht funktionsfähig ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt und ist immer auf 5 (OK) festgelegt.

Wert	Bedeutung
5	Die Integrität status ist normal.

InstallDate

Datentyp: datetime
Zugriffstyp: Schreibgeschützt

Das Datum und die Uhrzeit der Erstellung der Konfiguration des virtuellen Computers. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

InstanceID

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Schlüssel

Identifiziert eindeutig einen instance dieser Klasse. Diese Eigenschaft wird von CIM_ManagedElement geerbt und immer auf Null festgelegt.

Name

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Key, MaxLen ( 256 )

Die Bezeichnung, unter der das Objekt bekannt ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt und ist immer auf "replicasvc" festgelegt.

OperatingStatus

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Stellt aktuelle status Informationen für den Betriebszustand des Elements bereit und kann verwendet werden, um weitere Details in Bezug auf den Wert der EnabledState-Eigenschaft bereitzustellen. Ein Null-Wert gibt an, dass diese Eigenschaft nicht implementiert ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Unbekannt (0)
Nicht verfügbar (1)
Wartung (2)
Ab (3)
Beenden (4)
Beendet (5)
Abgebrochen (6)
Ruhend (7)
Abgeschlossen (8)
Migrieren (9)
Auswandern (10)
Immigrieren (11)
Momentaufnahme (12)
Herunterfahren (13)
In Test (14)
Übergang (15)
Im Dienst (16)
DMTF Reserviert (..)
Vendor Reserved (0x8000.. )

OperationalStatus

Datentyp: uint16-Array
Zugriffstyp: Schreibgeschützt

Ein Array, das die aktuellen Status des Objekts enthält. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt. Der Wert bei Index 0 ist einer der folgenden Werte.

Wert	Bedeutung
OK 2	Der Replikationsdienst funktioniert normal.
Fehler 6	Mindestens ein Replikationsnetzwerklistener wird nicht ausgeführt. Überprüfen Sie, ob die Replikationsdiensteinstellungen gültig sind.

OtherEnabledState

Datentyp: string
Zugriffstyp: Schreibgeschützt

Eine Zeichenfolge, die den aktivierten oder deaktivierten Zustand des Elements beschreibt, wenn die EnabledState-Eigenschaft auf 1 ("Sonstige") festgelegt ist. Diese Eigenschaft muss auf NULL festgelegt werden, wenn EnabledState einen anderen Wert als 1 aufweist. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt und immer auf Null festgelegt.

PrimaryOwnerContact

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: MaxLen ( 256 )

Alle Informationen darüber, wie der primäre Besitzer des Diensts erreicht werden kann (z. B. Telefonnummer, E-Mail-Adresse usw.). Diese Eigenschaft wird von CIM_Service geerbt und immer auf Null festgelegt.

PrimaryOwnerName

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: MaxLen ( 64 )

Der Name des primären Besitzers für den Dienst, sofern definiert. Der primäre Besitzer ist der erste Supportkontakt für den Dienst. Diese Eigenschaft wird von CIM_Service geerbt und immer auf Null festgelegt.

PrimaryStatus

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Stellt allgemeine status Informationen bereit. Diese Eigenschaft sollte in Verbindung mit der DetailedStatus-Eigenschaft verwendet werden, um eine allgemeine und detaillierte Integrität status des Elements und seiner Unterkomponenten bereitzustellen. Ein Null-Wert gibt an, dass diese Eigenschaft nicht implementiert ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Unbekannt (0)
OK (1)
Herabgestuft (2)
Fehler (3)
DMTF Reserviert (..)
Vendor Reserved (0x8000.. )

RequestedState

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Der letzte angeforderte oder gewünschte Zustand für das Element. Der tatsächliche Zustand des Elements wird durch EnabledState dargestellt. Diese Eigenschaft wird bereitgestellt, um den zuletzt angeforderten und den aktuellen Status für ein Element zu vergleichen. Eine bestimmte instance der CIM_EnabledLogicalElement-Klasse unterstützt die RequestedState-Eigenschaft möglicherweise nicht. In diesem Fall wird der Wert 12 ("Nicht zutreffend") verwendet. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt und immer auf 12 (Nicht zutreffend) festgelegt.

Wert	Bedeutung
12	Nicht zutreffend

Started

Datentyp: boolean
Zugriffstyp: Schreibgeschützt

Gibt an, ob der Dienst derzeit ausgeführt wird. Diese Eigenschaft wird von CIM_Service geerbt und ist immer auf True festgelegt.

StartMode

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: MaxLen ( 10 )

Ein Zeichenfolgenwert, der angibt, ob der Dienst automatisch von einem System, einem Betriebssystem oder nur auf Anforderung gestartet wird. Diese Eigenschaft wird von CIM_Service geerbt und immer auf Null festgelegt.

Status

Datentyp: string
Zugriffstyp: Schreibgeschützt

Gibt die status des Elements an. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt und ist immer auf "OK" festgelegt.

StatusBeschreibungen

Datentyp: Zeichenfolgenarray
Zugriffstyp: Schreibgeschützt

Zeichenfolgen, die die verschiedenen OperationalStatus-Arraywerte beschreiben. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

SystemCreationClassName

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Key, MaxLen ( 256 )

Der Name der Erstellungsklasse des Bereichssystems. Diese Eigenschaft wird von CIM_Service geerbt und immer auf "Msvm_ComputerSystem" festgelegt.

Systemname

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Key, MaxLen ( 256 )

Der NetBIOS-Name des Hostcomputersystems. Diese Eigenschaft wird von CIM_Service geerbt.

TimeOfLastStateChange

Datentyp: datetime
Zugriffstyp: Schreibgeschützt

Das Datum oder die Uhrzeit, zu dem sich der aktivierte Status des Elements zuletzt geändert hat. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt.

TransitioningToState

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Gibt den Zielzustand an, in den die instance übergehen. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt und ist immer auf NULL festgelegt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Namespace	Stamm\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe