BACKEND VARA-Objekte

Verwenden Sie BACKEND VARA-Objekte, um Befehle unter Betriebssystemen (Windows oder Unix) auszuführen, und stellen Sie das Ergebnis als Werte bereit, 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.

Hinweise:

Sie benötigen eine bestimmte Berechtigung, um BACKEND VARA-Objekte zu erstellen und zu ändern.
Die VAR_TIMEOUT (UC_HOSTCHAR_DEFAULT - Host-Charakteristika) und BACKENDVAR_MAX_ROWS in UC_SYSTEM_SETTINGS - Systemübergreifende Einstellungen stehen auch für BACKEND VARA-Objekte 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.

Diese Seite beinhaltet Folgendes:

Übersicht

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.
Variablen

Hier legen Sie die objektspezifischen Einstellungen fest. Einige Abschnitte dieser Seite gelten für alle VARA-Objekte und werden für all diese in eigenen Themen beschrieben:
- Variablen-Einstellungen, siehe unten
- Datentypen und Formatierung
- Script-Zugriff
- Mandant-0-VARA-Objekte in anderen Mandanten
- Vorschau, siehe unten
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.

Dieses Thema beschreibt, wie Sie die Seiten Variablen und Befehle konfigurieren.

Ein BACKEND VARA-Objekt definieren

Seite "Variablen"

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
- Agent der Aufgabe bevorzugen
  
  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 haben, tritt ein Fehler auf.
- 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 haben, tritt ein Fehler auf.
Hinweis e :

Folgendes gilt für die Attribute 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 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.

Seite "Kommandos"

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:
- OS Name
  
  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.
  - 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 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 mit dem ersten Zeichen und hat eine Länge von 20 Zeichen. "pid" beginnt bei Zeichen 25 und ist 10 Zeichen lang.
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 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 auf der Automic Web Interface verwendet wird.
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 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	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: