Definieren von VARA-Objekten vom Typ BACKEND

Benutzerdefinierte VARA-Objekte sind leistungsstarke dynamische Ausführungstools. Sie sind Platzhalter für Werte, die sie aus verschiedenen Quellen abrufen, abhängig vom Typ des VARA-Objekts. VARA-Objekte werden ausführbaren Objekten zugeordnet. Wenn diese ausführbaren Objekte verarbeitet werden, werden die VARA-Objekte durch deren Werte ersetzt. Als Entwickler und Objektdesigner erstellen und verwenden Sie VARA-Objekte in den Attributen und Scripts von ausführbaren Objekten. Als Administrator erstellen Sie im Mandanten 0 VARA-Objekte, die von anderen Benutzern in anderen Mandanten verwendet werden können.

Sie verwenden VARA-Objekte vom Typ BACKEND, um Kommandos unter Betriebssystemen (Windows oder UNIX) auszuführen, und das Ergebnis als Werte in Spalten auszugeben. Sie können die Befehle für verschiedene Betriebssysteme, Systemnamen und Versionen in einem BACKEND VARA-Objekt speichern. Wenn das VARA-Objekt aufgelöst wird, wird automatisch der richtige Befehl des betreffenden Agenten ausgewählt und ausgeführt.

Sie benötigen die Berechtigung Backend-Variablen anlegen und ändern, um VARA-Objekte vom Typ BACKEND zu erstellen und zu ändern. Weitere Informationen finden Sie unter Gewähren von Automation Engine-Berechtigungen.

Hinweise:

VAR_TIMEOUT (UC_HOSTCHAR_DEFAULT - Host-Charakteristika) und BACKENDVAR_MAX_ROWS in UC_SYSTEM_SETTINGS: Systemweite Einstellungen stehen auch für VARA-Objekte vom Typ BACKEND zur Verfügung.
Verwenden Sie hier PromptSet-Variablen, wenn Sie die Funktion Dynamisch aktualisieren für Kombinationsfeld-Eingabeaufforderungen verwenden. Die PromptSet-Variablen werden aufgelöst, wenn das Objekt, das die Eingabeaufforderung enthält, ausgeführt wird.

Wie alle anderen Objekte haben BACKEND-VARA-Objekte mehrere verschiedene Definitionsseiten. Allgemein, Versionsmanagement und Dokumentation existieren für alle Objekte. Hier werden die Seiten Variablen und "Kommandos" beschrieben, die für BACKEND-VARA-Objekte spezifisch sind.

Ein BACKEND VARA-Objekt definieren

Führen Sie auf der Seite Variablen folgende Schritte durch:
1. Geben Sie im Abschnitt Variableneinstellungen an, wie das VARA-Objekt auf das Zielsystem zugreifen soll, von dem es die Werte abruft.
  - Wählen Sie unter Agent den Agenten aus, auf dem das Kommando ausgeführt werden soll.
  - Wählen Sie Aufgaben-Agenten anwenden aus, um stattdessen den Agenten der Aufgabe zu verwenden, die das VARA-Objekt verwendet. Wenn die Aufgabe keinen Agenten hat (z. B. bei Script-Objekten), wird der Agent des VARA-Objekts verwendet. Wenn weder das VARA-Objekt noch die Aufgabe einen Agenten hat, tritt ein Fehler auf.
  - Wählen Sie das Login-Objekt aus, das dem VARA-Objekt Zugriff auf das Zielbetriebssystem ermöglicht.
  - Wählen Sie Aufgaben-Login anwenden aus, um das Login-Objekt zu verwenden, das der Aufgabe zugewiesen ist, die das VARA-Objekt verwendet. Wenn der Aufgabe kein Login-Objekt zugeordnet ist (z. B. bei Script-Objekten), wird das dem VARA-Objekt zugeordnete Login-Objekt verwendet. Wenn weder das VARA-Objekt noch die Aufgabe ein Login-Objekt hat, tritt ein Fehler auf.
  Hinweise:
  
  Folgendes gilt für die Eigenschaften Agent und Login:
  - Wenn Sie die Funktion für das dynamische Aktualisieren für Kombinationsfeld-Prompts verwenden, können Sie hier PromptSet-Variablen hinzufügen. Wenn Sie PromptSet-Variablen in einem dynamischen Variablenobjekt verwenden, gibt die Funktion Vorschau einen Fehler zurück. Der Grund hierfür ist, dass PromptSet-Variablen im dynamischen Variablenobjekt nicht existieren. Die PromptSet-Variablen werden jedoch aufgelöst, wenn Objekte, die PromptSet beinhalten, ausgeführt werden.
  - Die bereitgestellten Vorlagen für VARA-Objekte vom Typ BACKEND verwenden die folgenden PromptSet-Variablen: &AGENT# für den Agenten und &LOGIN# für das Login-Objekt.
2. Der Inhalt von VARA-Objekten vom Typ BACKEND ist immer ein alphanumerischer String. Daher ist der Typ immer Text. Dies wird im Abschnitt Daten & Formatierung angezeigt und kann nicht geändert werden. In diesem Abschnitt geben Sie das Datenformat des Werts an, der durch das VARA-Objekt gerendert wird. Führen Sie folgende Schritte durch:
  - Wählen SieTextlänge limitieren aus, um ein Limit für die Länge des Zeichen-Strings festzulegen.
  - Geben Sie unter Max. Textlänge die maximale Länge an. Mögliche Werte: 1 bis 1024
  - Wählen Sie Großschreibung erzwingen aus, wenn Sie den Text der ersten Wertspalte in Großbuchstaben konvertieren möchten.
  - Legen Sie unter Ergebnisformat das Format des Inhalts in der Spalte ERGEBNIS fest. Das ist die erste Spalte, die in der Vorschau angezeigt wird. Die Ergebnis-Spalte kann aus einer Kombination von Werte-Spalten und beliebigen anderen Zeichen bestehen.
    
    Spaltennummern, die in { }-Klammern im Feld Ergebnis-Format angegeben sind, werden durch den Wert der jeweiligen Spalte ersetzt.
    
    Beispiel:
    - Wert Spalte 1: JOB1
    - Wert Spalte 2: WIN01
    - Ergebnisformat: {1}_{2}
    - Ergebnisspalte: JOB01_WIN01
    Wenn Sie kein Ergebnisformat angeben, wird der Wert in der Spalte Ergebnis oder in der Spalte Schlüssel verwendet.
    
    Wichtig!
    - Das Ergebnis muss innerhalb der definierten Grenzen liegen und dem Datentyp entsprechen. Ansonsten zeigt die Resultat-Spalte keinen Wert an.
    - Die Beschränkungen (Min. Wert, Max. Wert, Textlimitierung) haben auf die Ergebnisspalte keinen Einfluss, sondern nur auf die erste zurückgelieferte Spalte. Wenn die Werte dieser Spalte den maximalen Bereich überschreiten, wird diese Zeile übersprungen. Die Zeile ist nicht über das VARA-Objekt verfügbar.
3. Alle VARA-Objekte haben den Abschnitt Script-Zugriff auf ihren Definitionsseiten, der die Fehlerbehandlung festlegt, wenn Scripts das VARA-Objekt lesen. In diesem Bereich entscheiden Sie, was passieren soll, wenn Scripts auf das VARA-Objekt zugreifen und der Schlüssel, auf den sie verweisen, nicht verfügbar ist.
  
  Folgende Optionen stehen zur Verfügung:
  - Fehler zurückliefern
    
    Das Script wird nicht ordnungsgemäß beendet, und auf der Meldungen-Konsole wird eine Laufzeitfehlermeldung angezeigt.
  - Anfangswerte zurückgeben (Standard)
    
    Das Script wird weiterhin ausgeführt, obwohl der Schlüssel nicht verfügbar ist. Es wird kein Laufzeitfehler angezeigt. Der Report enthält einen leeren String, woran zu erkennen ist, dass kein Schlüssel gefunden wurde.
    
    Tipp: Stellen Sie sicher, dass die Schlüssel von VARA-Objekten immer einen Wert zurückgeben, wenn Sie diese Option verwenden möchten.
VARA-Objekte vom Typ BACKEND führen genau ein Kommando unter dem Zielbetriebssystem aus. Dies gilt sowohl für Windows als auch für Unix. Sie geben das Kommando für Windows oder Unix auf der Seite Kommando ein. Weitere Informationen finden Sie unter Definieren der Befehle für BACKEND-VARA-Objekte.
Klicken Sie auf die Schaltfläche Vorschau, um den Befehl auf dem Zielcomputer auszuführen und die Ergebnisse zu testen.
Um den Inhalt der Vorschautabelle in eine CSV-Datei zu exportieren, klicken Sie auf Tabelle exportieren. Alle Zeilen und Spalten werden exportiert. Verwenden Sie diese Funktion, wenn Sie den Inhalt der CSV-Datei weiter verarbeiten müssen (ihn in eine andere Anwendung zur weiteren Verarbeitung einfügen usw.).
Um eine oder mehrere Zeilen in der Vorschautabelle zu kopieren, wählen Sie die Schaltfläche Kopieren aus. Die ausgewählten Zeilen werden in die Zwischenablage kopiert und Sie können sie in ein Drittanbieter-Tool (Google, Sheets, Excel, Texteditor usw.) einfügen.

Hinweis: Diese Funktion ist nur verfügbar, wenn https in der Automic Web Interface verwendet wird.
Speichern Sie das Objekt.

Vordefinierte BACKEND-VARA-Objekte (Vorlagen)

Ein Automic Automation-System verfügt über vordefinierte BACKEND-VARA-Objekte in Mandant 0 im Ordner UC_RB_VARIABLES. Sie können für die Funktion Dynamisch aktualisieren verwendet werden.

Die Agenten dieser vordefinierten Objekte werden unter Verwendung der Variablen &AGENT# angegeben. Ihre Login-Objekte werden mit der Variablen &LOGIN# angegeben. Verwenden Sie diese Namen für die PromptSet-Variablen der erforderlichen Elemente.

Objektname	Betriebssystem	Funktion	Spalten
UC_RB_VARA_PROCESSLIST	Windows, Linux, AIX, SunOS	Listet die aktiven Prozesse auf. Die maximale Länge der Prozess-ID kann abhängig vom jeweiligen UNIX-System unterschiedlich sein. Passen Sie gegebenenfalls die Spaltenlänge im Variablenobjekt an.	ProcessID Prozessname
UC_RB_VARA_SERVICES_PAUSED	Windows, Linux, AIX, SunOS	Listet alle pausierten Dienste auf.	Dienstname
UC_RB_VARA_SERVICES_RUNNING	Windows, Linux, AIX, SunOS	Listet alle gestarteten Dienste auf.	Dienstname
UC_RB_VARA_SERVICES_STOPPED	Windows, Linux, AIX, SunOS	Listet alle gestoppten Dienste auf.	Dienstname
UC_RB_VARA_USERLIST	Windows, Linux, AIX, SunOS	Listet alle Benutzer des Betriebssystems auf. Windows: Für Windows gilt dazu die Voraussetzung, dass Active Directory für PowerShell auf dem jeweiligen Rechner installiert ist!	Benutzer(Konto)-Name

Siehe auch: