Konfigurieren Sie die Protokollierung für den PowerShell-Schritt

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 2 Minuten Lesedauer

    • Fügen Sie den Skripts in Ihrem PowerShell-Schritt Protokollnachrichten hinzu. Verwenden Sie Protokollebenen, um die Protokollierung und das Debugging zu verbessern.

    Vorbereitungen

    Um Ihrem Skript Protokollnachrichten hinzuzufügen, müssen Sie verwenden Schreib-SNCLog Funktion. Diese Funktion ist im Modul „IH\Logging.psm1“ definiert. Verwenden Sie PSScript.ps1, um dieses Modul zu importieren, damit Inline-Skripts Zugriff auf haben Schreib-SNCLog . Weitere Informationen finden Sie unter PowerShell-Dateien des MID-Servers .

    Erforderliche Rolle: Administrator

    Prozedur

    1. Navigieren zu Alle > MID-Server > Eigenschaftenan.
    2. Festlegen mid.property.powershell.log_infoBis Wahr .
      Diese Eigenschaft aktiviert oder deaktiviert die Protokollierung. Weitere Informationen finden Sie unter PowerShell-Protokolleigenschaft .
    3. Festlegen mid.property.powershell.ih.log_levelAuf die gewünschte Protokollebene.
      Die Protokollebene gibt den Schwellenwert an, der zum Protokollieren einer Nachricht erforderlich ist. Nachrichten werden auf der angegebenen Ebene oder höher protokolliert. Wenn diese Eigenschaft beispielsweise auf „WARNUNG“ festgelegt ist, werden Nachrichten mit der Stufe „WARNUNG“ oder „FEHLER“ protokolliert. Nachrichten mit der Ebene „INFO“, „DEBUG“ oder „TRACE“ werden nicht protokolliert. Die Ebenen, von niedrig nach hoch aufgelistet, sind:
      • TRACE
      • DEBUG
      • INFO
      • WARN
      • ERROR
      Der Standardwert ist INFO.
    4. Wahlweise: Konfigurieren Sie eine Systemeigenschaft, damit Sie die Protokolle in der Instanz anzeigen können.
      1. Navigieren zu Alle > Prozessautomatisierung > Flow Designer > Eigenschaftenan.
      2. Suchen Geben Sie die Protokollebene der Systemprotokolleinträge an, die im Flow-Protokoll repliziert werden sollen. Das System repliziert nur Protokolleinträge der angegebenen Ebene oder höher Und legen Sie sie auf fest INFO Oder DEBUGGEN .

      Nachdem Sie das PowerShell-Skript erstellt und ausgeführt haben, sind die Protokolle im MID-Agent-Protokoll verfügbar. Durch die Konfiguration dieser Eigenschaft können Sie sie auch direkt in der Instanz anzeigen.

      Dieser Schritt legt fest com.glide.hub.flow_engine.listener_trace.thresholdEigenschaft. Repliziert die Protokolle in die Tabelle „Flow-Engine-Protokolleinträge“ [sys_Flow_log].

    5. Fügen Sie in Ihrem PowerShell-Skript Protokollnachrichten und -Ebenen mit hinzu Schreib-SNCLog Funktion.
      Tabelle : 1. Write-SNCLog-Funktion und -Parameter
      Name Beschreibung
      Schreib-SNCLog Funktion Protokollieren Sie eine Nachricht für den PowerShell-Schritt. Schreib-SNCLog Hat zwei Parameter, -LevelUnd -Message. Beide Parameter sind erforderlich, die Parameternamen sind jedoch nicht. Wenn die Namen ausgelassen werden, wird die Position verwendet, um die Ebene und die Nachricht zu bestimmen. Beispiele:
      • Write-SNCLog-Level-WARNUNG – Meldung „Protokollwarnung“
      • Write-SNCLog-WARNUNG „Protokollwarnung“
      Protokoll dieser beiden Beispiele WARNUNG: Warnung protokollieren .
      -Level Parameter Geben Sie die Ebene für die Protokollnachricht an. Gültige Werte sind:
      • ERROR
      • WARN
      • INFO
      • DEBUG
      • TRACE
      Dieser Parameter ist erforderlich.
      -Message Parameter Geben Sie die zu protokollierende Nachricht an. Als Zeichenfolge eingegeben. Dieser Parameter ist erforderlich.
    6. Fahren Sie mit der Erstellung Ihrer Aktion oder Ihres Flows fort, testen Sie sie, und führen Sie sie aus.

    Nächste Maßnahme

    Die neuen Protokolle sind im MID-Agent-Protokoll verfügbar und können vom MID-Server heruntergeladen werden. Weitere Informationen finden Sie unter Laden Sie die MID-Server-Dateien herunter .

    Wenn Sie die Systemeigenschaft so festlegen, dass die Protokolle in der -Instanz angezeigt werden, können Sie sie im anzeigen Flow-Engine-Protokolleinträge Registerkarte des Flow Engine-Kontextdatensatzes. Weitere Informationen finden Sie unter Flow-Ausführungsdetails .