BACKEND VARA-Objekte

Verwenden Sie BACKEND VARA-Objekte, um Befehle unter Betriebssystemen (Windows oder UNIX) auszuführen, und geben Sie das Ergebnis als Werte an, die in Spalten angezeigt werden. 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 eine bestimmte Berechtigung, um BACKEND VARA-Objekte zu erstellen und zu ändern.

PromptSet-Variablen werden in ausgewählten Feldern für Variablen des Typs BACKEND, EXEC, FILELIST, SEC_SQLI, SEC_SQL, SQLI, SQL und XML unterstützt. Die Verwendung von PromptSet-Variablen ist notwendig, wenn die Funktion Dynamisch aktualisieren (Kombinationsfeld-Prompts) verwendet wird.

Sie können die folgenden Systemvariablen mit BACKEND VARA-Objekten verwenden:

VAR_TIMEOUT (UC_HOSTCHAR_DEFAULT - Host-Charakteristika)
BACKENDVAR_MAX_ROWS

BACKEND VARA-Objekte definieren

Eine BACKEND VARA-Objektdefinition besteht aus den folgenden Seiten:

Seite "Allgemein"

Gemeinsam für alle Objekttypen definieren Sie hier grundlegende Objektinformationen und wenden benutzerdefinierte Werte auf sie an.
Die Seite Variablen definieren

Hier legen Sie die objektspezifischen Einstellungen fest. Einige Abschnitte dieser Seite gelten für alle VARA-Objekte und werden in jeweils eigenen Themen beschrieben. In diesem Thema werden die BACKEND-spezifischen Einstellungen auf den Seiten Variablen und Befehle beschrieben.
Die Seite Befehle definieren
Seite "Versionsmanagement"

Allgemein für alle Objekttypen finden Sie hier eine Liste aller Versionen des Objekts.
Seite "Dokumentation"

Hier geben Sie die Informationen ein, die Sie als wichtig erachten, um die Konfiguration und das Verhalten des Objekts zu verstehen.

Die Seite Variablen definieren

Geben Sie im Abschnitt Variableneinstellungen an, wie das VARA-Objekt auf das Zielsystem zugreifen soll, von dem es die Werte abruft:
- Agent
  
  Der Agent, in dem der Befehl ausgeführt wird
- Aufgaben-Agenten verwenden
  
  Verwendet den Agenten der Aufgabe, die das VARA-Objekt verwendet. Wenn die Aufgabe keinen Agenten hat (wie z. B. in Script-Objekten), wird der Agent des VARA-Objekts verwendet. Wenn weder das VARA-Objekt noch die Aufgabe einen Agenten hat, tritt ein Fehler auf.
- Login
  
  Login (LOGIN) Objekt, das dem VARA-Objekt den Zugriff auf das Zielbetriebssystem ermöglicht.
- Login der Aufgabe bevorzugen
  
  Verwendet den Login der Aufgabe, die das VARA-Objekt verwendet. Wenn der Aufgabe kein Login-Objekt zugeordnet ist (z. B. in Script-Objekten), wird das dem VARA-Objekt zugeordnete Login verwendet. Wenn weder das VARA-Objekt noch die Aufgabe ein Login-Objekt hat, tritt ein Fehler auf.
Hinweise:

Folgendes gilt für die Attribute Agent und Login:
- Hier können Sie PromptSet-Variablen aufnehmen, wenn Sie die Funktion Dynamisch aktualisieren (Kombinationsfeld-Prompts) für Kombinationsfeld-Eingabeaufforderungen verwenden. 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 Vordefinierte BACKEND VARA-Objekte (Vorlagen) for Backend VARA-Objekte verwenden die PromptSet-Variables &AGENT# für ihren angegebenen Agenten und &LOGIN# für ihr Login.
Definieren Sie Datentypen und Formatierung.
Definieren Sie den Script-Zugriff.
Wenn Sie bei Mandant 0 angemeldet sind, ist ein zusätzlicher Abschnitt verfügbar. Weitere Informationen finden Sie unter Mandant-0-VARA-Objekte in anderen Mandanten.

Die Seite Befehle definieren

BACKEND VARA-Objekte führen genau einen Befehl auf den Zielbetriebssystemen aus. Dies gilt sowohl für Windows als auch für Unix. Sie geben den Befehl auf dieser Seite ein:

Geben Sie in den Abschnitten Windows oder UNIX Folgendes an:
- Betriebssystemname
  Name des Betriebssystems, auf dem der Agent ausgeführt wird. Verwenden Sie den Wert, der in der Administration-Perspektive angezeigt wird (Seite Agenten, Spalte Software).
- Erlaubte Zeichen: *
- Version
  
  Version des Agenten, die in der Administration-Perspektive (Seite Agenten, Spalte Software) angezeigt wird.
- Kommando
  - Bei Windows werden nur Powershell-Kommandos unterstützt.
  - Hier können Sie PromptSet-Variablen aufnehmen, wenn Sie die Funktion Dynamisch aktualisieren (Kombinationsfeld-Prompts) für Kombinationsfeld-Eingabeaufforderungen verwenden.
  - Wenn Sie PromptSet-Variablen in einem dynamischen Variablenobjekt verwenden, gibt die Funktion Vorschau einen Fehler zurück. Der Grund dafür ist, dass die PromptSet-Variablen im BACKEND VARA-Objekt nicht existieren. Die PromptSet-Variablen werden jedoch aufgelöst, wenn Objekte, die PromptSet beinhalten, ausgeführt werden.
- Spaltenformat
  
  Legt fest, wie das Ergebnis in Spalten aufgeteilt werden soll. Verwenden Sie die folgende Syntax:
  
  Spaltenname:Startposition(Länge) [;Spaltenname:Startposition(Länge) . . .]
  
  Wobei:
  - Spaltenname = Name der Spalte, benutzerdefiniert
  - Startposition = Position des Zeichens, an dem die Spalte beginnt
  - Länge = Anzahl der Zeichen, die die Größe der Spalte bestimmt
  Wichtig!
  - Das Semikolon (;) ist nur zwischen mehreren Spaltenangaben zu verwenden! Am Ende der gesamten Definition ist kein Semikolon erforderlich.
  - Es ist zumindest eine Werte-Spalte zu definieren.
  Beispiel:
  
  process:1(20);pid:25(10)
  
  Dieses Beispiel teilt die Ausgabe des Befehls in zwei Spalten auf. Die Spalte Prozess beginnt beim ersten Zeichen und ist 20 Zeichen lang. "pid" beginnt bei Zeichen 25 und besitzt eine Länge von 10 Zeichen.
Wichtige Hinweise
- Windows
  
  Die Befehle sind keine Batch-Zeilen. Sie müssen ein bestimmtes Programm definieren, das ausgeführt werden soll.
  
  Beispiele:
  - Verzeichnis auflisten: cmd /c dir C:\temp
  - Ping: ping localhost -n 10
  Der Rückgabewert wird automatisch auf 1 gesetzt, wenn ein Befehl zu einem Fehler führt. In diesem Fall bricht das Script ab, wenn Sie das VARA-Objekt in einem Script verwenden. Um dies zu vermeiden, können Sie & set ERRORLEVEL=0 am Ende des Windows-Befehls anhängen.
  
  Beispiel:
  
  cmd /c dir /b /o:d C:\temp\*.xml & set ERRORLEVEL=0
  
  Das Kommando listet Dateien eines Verzeichnisses auf. Der Rückgabewert ist allerdings immer 0, unabhängig davon, ob Dateien gefunden wurden oder nicht. Auf diese Weise können Sie sicherstellen, dass die Aufgaben, die dieses VARA-Objekt verwenden, nicht abgebrochen werden.
- Unix
  
  Der Benutzer im Login-Objekt muss das Recht zur Ausführung des Kommandos besitzen.
- Windows und Unix
  
  In den Spalten OS-Name und Version können Sie nach den Namen (z. B. einem bestimmten UNIX-Derivat) und der OS-Version filtern. Die passende Zeile für den angegebenen Agenten wird automatisch verwendet, wenn das VARA-Objekt ausgeführt wird. Es wird dabei der erste Eintrag verwendet, der auf Betriebssystem, OS-Namen und Version des Agenten zutrifft!
- Linux
  
  Root-Rechte sind für die Befehle chkconfig und runlevel erforderlich.
Klicken Sie auf die Schaltfläche Vorschau, um den Befehl auf dem definierten Computer auszuführen und die Ergebnisse zu testen.
Speichern Sie Ihre Änderungen.

Vordefinierte BACKEND VARA-Objekte (Vorlagen)

Vordefinierte BACKEND VARA-Objekte werden im Mandant 0 im Ordner UC _RB_VARIABLES ausgeliefert. Sie können für die Funktion Dynamisch aktualisieren (Kombinationsfeld-Prompts) verwendet werden.

Ihre Agenten werden über die Variable &AGENT# angegeben. Ihr Anmeldeobjekt wird mit der Variablen &LOGIN# angegeben. Achten Sie darauf, diese Namen für die PromptSet-Variablen der gewünschten Elemente zu verwenden.

Objektname	Betriebssystem	Funktion	Spalten
UC_RB_VARA_PROCESSLIST	Windows, Linux, AIX, SunOS, HP-UX	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, HP-UX	Listet alle pausierten Dienste auf.	Dienstname
UC_RB_VARA_SERVICES_RUNNING	Windows, Linux, AIX, SunOS, HP-UX	Listet alle gestarteten Dienste auf.	Dienstname
UC_RB_VARA_SERVICES_STOPPED	Windows, Linux, AIX, SunOS, HP-UX	Listet alle gestoppten Dienste auf.	Dienstname
UC_RB_VARA_USERLIST	Windows, Linux, AIX, SunOS, HP-UX	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: