Freigeben über


Vorgehensweise: Arbeiten mit Replikations-Agentprofilen (RMO-Programmierung)

Mithilfe von Replikations-Agentprofilen werden beim Erstellen eines Agentauftrags die Standardwerte definiert. Jeder Agent verfügt über ein Standardprofil, und einige Agents verfügen über zusätzliche vordefinierte Profile. Sie können benutzerdefinierte Profile mithilfe von Replikationsverwaltungsobjekten (RMO) erstellen. Informationen zu Profilen finden Sie unter Replikations-Agent-Profile.

So erstellen Sie ein neues Agentprofil

  1. Erstellen Sie eine Verbindung mit dem Verteiler, indem Sie eine Instanz der ServerConnection-Klasse verwenden.

  2. Erstellen Sie eine Instanz der AgentProfile-Klasse.

  3. Legen Sie die folgenden Eigenschaften für das Objekt fest:

    • Name - der Name des Profils.

    • AgentType - ein AgentType-Wert, der den Typ des Replikations-Agents angibt, für den das Profil erstellt wird.

    • ConnectionContext - die in Schritt 1 erstellte ServerConnection.

    • (Optional) Description - eine Beschreibung des Profils.

    • (Optional) Default - Legen Sie diese Eigenschaft auf true fest, wenn alle neuen Agentaufträge für diesen AgentType dieses Profil standardmäßig verwenden.

  4. Rufen Sie die Create-Methode auf, um das Profil auf dem Server zu erstellen.

  5. Sobald das Profil auf dem Server vorhanden ist, können Sie es anpassen, indem Sie Werte für die Parameter für Replikations-Agents hinzufügen, entfernen oder ändern.

  6. Rufen Sie die AssignToAgent-Methode auf, um das Profil einem vorhandenen Replikations-Agent-Auftrag zuzuordnen. Übergeben Sie den Namen der Verteilungsdatenbank für distributionDBName und die ID des Auftrags für agentID.

So ändern Sie ein vorhandenes Agentprofil

  1. Erstellen Sie eine Verbindung mit dem Verteiler, indem Sie eine Instanz der ServerConnection-Klasse verwenden.

  2. Erstellen Sie eine Instanz der ReplicationServer-Klasse. Übergeben Sie das in Schritt 1 erstellte ServerConnection-Objekt.

  3. Rufen Sie die LoadProperties-Methode auf. Überprüfen Sie, ob der Verteiler vorhanden ist, wenn diese Methode false zurückgibt.

  4. Rufen Sie die EnumAgentProfiles-Methode auf. Übergeben Sie einen AgentType-Wert, um die zurückgegebenen Profile für einen bestimmten Typ von Replikations-Agent einzugrenzen.

  5. Rufen Sie das gewünschte AgentProfile-Objekt von der zurückgegebenen ArrayList ab, wobei die Name-Eigenschaft des Objekt mit dem Profilnamen übereinstimmt.

  6. Rufen Sie eine der folgenden Methoden von AgentProfile auf, um das Profil zu ändern:

    • AddParameter - fügt dem Profil einen unterstützten Parameter hinzu, wobei name der Name des Parameters für den Replikations-Agent und value der angegebene Wert ist. Rufen Sie zum Aufzählen aller unterstützten Agentparameter für einen bestimmten Agenttyp die EnumParameterInfo-Methode auf. Diese Methode gibt eine ArrayList von AgentProfileParameterInfo-Objekten zurück, die alle unterstützten Parameter darstellen.

    • RemoveParameter - entfernt einen vorhandenen Parameter aus dem Profil, wobei name der Name des Parameters für den Replikations-Agent ist. Rufen Sie zum Aufzählen aller aktuellen Agentparameter, die für das Profil definiert sind, die EnumParameters-Methode auf. Diese Methode gibt eine ArrayList von AgentProfileParameter-Objekten zurück, die den vorhandenen Parameter für dieses Profil darstellen.

    • ChangeParameter - ändert die Einstellung eines vorhandenen Parameters im Profil, wobei name der Name des Agentparameters und newValue der Wert ist, in den der Parameter geändert wird. Rufen Sie zum Aufzählen aller aktuellen Agentparameter, die für das Profil definiert sind, die EnumParameters-Methode auf. Diese Methode gibt eine ArrayList von AgentProfileParameter-Objekten zurück, die den vorhandenen Parameter für dieses Profil darstellen. Rufen Sie zum Aufzählen aller unterstützten Einstellungen für den Agentparameter die EnumParameterInfo-Methode auf. Diese Methode gibt eine ArrayList von AgentProfileParameterInfo-Objekten zurück, die die unterstützten Werte für alle Parameter darstellen.

So löschen Sie ein Agentprofil

  1. Erstellen Sie eine Verbindung mit dem Verteiler, indem Sie eine Instanz der ServerConnection-Klasse verwenden.

  2. Erstellen Sie eine Instanz der AgentProfile-Klasse. Legen Sie den Namen des Profils für Name und ServerConnection aus Schritt 1 für ConnectionContext fest.

  3. Rufen Sie die LoadProperties-Methode auf. Wenn diese Methode false zurückgibt, wurde ein falscher Name angegeben, oder das Profil ist auf dem Server nicht vorhanden.

  4. Stellen Sie sicher, dass die Type-Eigenschaft auf User festgelegt ist, womit ein Kundenprofil angegeben wird. Entfernen Sie kein Profil, das einen Wert System für Type aufweist.

  5. Rufen Sie die Remove-Methode auf, um das benutzerdefinierte Profil, das durch dieses Objekt dargestellt wird, vom Server zu entfernen.