Variablen verwenden

Mithilfe von Variablen können Sie Werte speichern, auf die in mehreren Verfahrensschritten verwiesen werden kann. Variablen werden automatisch an verschachtelte Verfahren übergeben.

• Zwei Methoden zum Erstellen von Variablen:
  • Verfahrensvariablen – Verwenden Sie den Befehl getVariable() in einem Verfahren, um einen neuen Variablennamen ohne Sonderzeichen zu erstellen. Beispiel: VariableName. In nachfolgenden Schritten, auch jenen in verschachtelten Verfahren, verweisen Sie auf den Variablennamen mit dem Zeichen #. Beispiel: #VariableName#.

  Hinweis: Außer im Fall von GLOBAL-Variablen können Verfahrensvariablen nicht außerhalb desselben Verfahrens bzw. derselben verschachtelten Verfahren referenziert werden. Eine Verfahrensvariable ist nur in dem Abschnitt des Verfahrens und allen untergeordeneten Verfahren sichtbar, in dem sie erstellt wurde. Sobald ein Verfahren die THEN- oder ELSE-Klausel verlässt, in dem die Variable erstellt wurde, fällt die Variable aus dem Bereich heraus und ist nicht länger gültig. Verwenden Sie wie unten beschreiben GLOBALE Variablen, damit die Variable nach Verlassen der THEN- oder ELSE-Klausel, in der sie erstellt wurde, weiter sichtbar ist.

  • Verwaltete Variablen – Verwenden Sie den Variablen-Manager, um Variablen zu definieren, die wiederholt in verschiedenen Verfahren verwendet werden können. Sie können mehrfache Werte für jede verwaltete Variable pflegen. Jeder Wert wird auf eine oder mehrere Gruppen-IDs angewendet. Verwalteten Variablen können keine neuen Werte innerhalb eines Verfahrens zugewiesen werden. In einem Verfahren verweisen Sie auf eine verwaltete Variable, indem Sie den Variablennamen mit den Zeichen < und > einklammern. Beispiel: <VariableName>.
  • GLOBALE Variablen – Nicht-GLOBALE Variablen können keinen geänderten Wert einer Verfahrensvariablen, die durch ein übergeordnetes Verfahren definiert wurde, zurückgeben. Nicht-GLOBALE Variablen, die im untergeordneten Verfahren initialisiert wurden, können ebenfalls nicht zum übergeordneten Verfahren zurückgegeben werden. Variablennamen mit dem Präfix GLOBAL: (keine Unterscheidung zwischen Groß- und Kleinschreibung, mit anschließendem Doppelpunkt) können geänderte Werte vom untergeordneten in das übergeordnete Verfahren zurückgeben, ganz gleich, ob die Variable im übergeordneten oder untergeordneten Verfahren initialisiert wurde. Nachfolgende untergeordnete Verfahren können jede GLOBALE Variable verwenden, die in einem früheren Schritt initialisiert wurde, ganz gleich, ob diese globale Variable in einem übergeordneten Verfahren oder einem anderen untergeordneten Verfahren initialisiert wurde.
• Variablennamen – Variablennamen dürfen keine der folgenden Zeichen enthalten: , % ' " / \ : * ? < > | und Leerzeichen.
• Verwendungsbereich – Nach der Erstellung von Variablen können diese im Klammernformat in jedes Texteingabefeld eingeschlossen werden, das in einem IF-ELSE--SCHRITT-Dialogfeld angezeigt wird.
• Groß-/Kleinschreibung – Bei Variablennamen muss auf Groß-/Kleinschreibung geachtet werden.
• Reservierte Zeichen – Da die Zeichen <, > und # zur Kennzeichnung von Variablennamen verwendet werden, müssen diese Zeichen zweimal als normaler Text in eine Befehlszeile eingegeben werden. Beispielsweise wird der Befehl c:\dir >> filelist.txt bei Ausführung des Verfahrens als c:\dir > filelist.txt interpretiert.
• Mögliche Arten von Variablenwerten – Es folgen die Arten von Variablenwerten, die normalerweise bei Verwendung des Parameters getVariable() abgerufen werden.
  • Registrierungswert und 64-Bit-Registrierungswert – Siehe 64-Bit-Befehle – Daten aus dem angegebenen Registrierungswert auf dem verwalteten Rechner. Der letzte einzelne Schrägstrich in einer Zeichenfolge dient zur Abgrenzung des Registrierungsschlüssels vom Registrierungswert. Wenn Ihre Zeichenfolge Schrägstriche enthalten soll, müssen diese als doppelte Schrägstriche angegeben werden. Die Zeichenfolge HKEY_LOCAL_MACHINE\SOFTWARE\SomeKey\Value\\Name wird beispielsweise als Schlüssel namens HKEY_LOCAL_MACHINE\SOFTWARE\SomeKey mit dem Wert Value\Name interpretiert.
  • Dateiinhalt – Daten aus einer angegebenen Datei auf dem verwalteten Rechner Siehe 64-Bit-Befehle.
  • Konstantenwert – Die angegebene Konstante, so wie sie im Verfahrenseditor eingegeben wurde
  • Installationsverzeichnispfad für den Agent – Das Verzeichnis, in dem der Agent auf dem verwalteten Rechner installiert ist
  • Agent-Installationslaufwerk – Das Laufwerk, auf dem der Agent auf dem verwalteten Rechner installiert ist, z. B. c:\
  • Pfad für Arbeitsverzeichnis des Agents – Das Arbeitsverzeichnis auf dem verwalteten Rechner, das über Agent > Working Directory festgelegt wurde.

    Warnung: Löschen Sie keine Dateien und Ordner im Arbeitsverzeichnis. Der Agent verwendet die im Arbeitsverzeichnis gespeicherten Daten, um verschiedene Aufgaben auszuführen.

  • Benutzer temporäres Verzeichnis – Das temporäre Verzeichnis des Benutzers, der gegenwärtig am verwalteten Rechner angemeldet ist. Dieser Pfad ist die Erweiterung der Umgebungsvariablen %TEMP% für den gegenwärtig angemeldeten Benutzer. Falls kein Benutzer angemeldet ist, stellt dies das standardmäßige temporäre Windows-Verzeichnis dar.
  • Rechner-Gruppen-ID – Dies ist die Rechner-ID des Agents, der das Verfahren ausführt.
  • Versionsnummer der Datei – Die Softwareversionsnummer der angegebenen Datei auf dem verwalteten Rechner. Zum Beispiel enthält eine exe- oder dll-Datei häufig die Nummer ihrer Version.
  • Dateigröße – Dies ist die Größe (in Byte) der angegebenen Datei auf dem verwalteten Rechner.
  • Letztes Änderungsdatum der Datei – Dies ist das Datum und die Uhrzeit der letzten Änderung in koordinierter Weltzeit (UTC) der angegebenen Datei auf dem verwalteten Rechner im Format yyyy/mm/dd hh:mm:ss.
  • Automatische SQL-Ansichtsdatenvariablen – SQL-Ansichtsparameter sind als automatisch deklarierte Verfahrensvariablen verfügbar. Automatische Variablen ermöglichen Ihnen den Befehl Variable abrufen zu überspringen, bevor Sie die Variable in einem SCHRITT einsetzen. Verwenden Sie das Format #SqlViewName.ColumnName# in einem Verfahren, um den Wert einer dbo.SqlView.Column für den Agent zurückzugeben, der das Agent-Verfahren ausführt. Eine Liste der verfügbaren SQL-Ansichten und Spalten finden Sie unter System > Datenbankansichten.

    Hinweis: SQL-Ansichtsdaten – Dieses ältere Verfahren zur Rückgabe eines Datenbankansichtswerts ist nur erforderlich, wenn Sie versuchen, einen Wert von anderen Rechnern, auf denen das Agent-Verfahren nicht ausgeführt wird, zurückzugeben.
    
    Verwenden Sie den Befehl Variable abrufen mit der Option SQL-Ansichtsdaten, um eine neue Verfahrensvariable zu erstellen und auf den Wert eines dbo.SqlAnsicht.Spalte-Wertes einzustellen. Verwenden Sie das Format SqlViewName/ColumnName/mach.groupID oder SqlViewName/ColumnName. Wenn die optionale Rechner-ID weggelassen wird, wird der Wert für den Agent abgerufen, der das Verfahren ausführt. Falls ColumnName eine Leerstelle enthält, schließen Sie sie in eckige Klammern ein. Beispiel: vSystemInfo/[Product Name]. Unter "System > Datenbanksichten finden Sie eine Liste der verfügbaren SQL-Ansichten und Spalten.

  • Automatische Administrator-Variablen – Drei Administrator-Variablen werden automatisch festgestellt. Dieese automatischen Administrator-Variablen ermöglichen, dass Agent-Verfahren Zugriff auf Werte haben, die nicht in einer SQL-Ansicht angezeigt werden.
    • #adminDefaults.adminEmail# – E-Mail-Adresse des VSA-Benutzers, der das Agent-Verfahren geplant hat
    • #adminDefaults.adminName# – Name des VSA-Benutzers, der das Agent-Verfahren geplant hat
    • #scriptIdTab.scriptName# – Name des Agent-Verfahrens
  • WMI -Eigenschaft – WMI-Adressraum, -Klasse und -Eigenschaft. Das Format der angegeben WMI-Eigenschaft lautet NameSpace:Class.Property. Beispiel: root\cimv2:Win32_OperatingSystem.FreePhysicalMemory. Geben Sie eine Instanz in der folgenden Syntax an: NameSpace:Class[N].Property, wobei [N] die Instanznummer ist. Beispiel: root\cimv2:Win32_OnboardDevice[3].Description. Die erste Instanz kann mit oder ohne Instanznummer [1] angegeben werden.
  • Ausdruckswert – Geben Sie einen Ausdruck an, der aus Verfahrensvariablen und den sechs mathematischen Operatoren +, -, *, /, ( und ) besteht, die bewertet und einer neuen Verfahrensvariable zugewiesen werden. Beispiel: ((#variable1# + #variable2#) + 17.4) / (#variable3# * 4). Die Verfahrensvariablen müssen numerische Werte enthalten.
  • Aufforderung, wenn Verfahren geplant ist – Sie werden in einer Meldung zur Eingabe eines Werts aufgefordert, wenn ein Agent-Verfahren ausgeführt wird. Der Wert wird im angegebenen Variablennamen gespeichert. Geben Sie den Aufforderungstext und Variablennamen ein. Beispielsweise könnte ein VSA-Benutzer bei jeder Ausführung dieses Verfahrens ein anderes Rechnerverzeichnis eingeben.
• Meldungsvariablen – Ein Agent-Verfahren kann so zugewiesen werden, dass es bei Auslösung einer Meldung ausgelöst wird. In den meisten Fällen übergibt die Meldung vordefinierte Werte an das Agent-Verfahren. Diese Meldungsvariablen werden nach Thema dokumentiert. Ein Beispiel dafür finden Sie unter Meldungen – Neuer Agent installiert.
• Windows-Umgebungsvariablen – Windows-Umgebungsvariablen können ausschließlich in den Befehlen executeFile(), Datei im Verzeichnispfad ausführen und executeShellCommand() referenziert werden. Umschließen Sie den gesamten Befehl mit Ausführungszeichen, denn die Umgebungsvariable kann Leerschritte enthalten, die die Ausführung beeinträchtigen können. Für andere Agent-Verfahren-Befehle nutzen Sie getVariable(), um den Registrierungsschlüssel mit der Umgebungsvariablen aus HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Environment abzurufen.