Konfigurieren Sie die Protokollierung für den PowerShell-Schritt

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 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 die Funktion Write-SNCLog verwenden. Diese Funktion ist im Modul IH\Logging.psm1 definiert. Verwenden Sie PSScript.ps1, um dieses Modul zu importieren, damit Inline-Skripts Zugriff auf Write-SNCLoghaben. Weitere Informationen finden Sie unter MID-Server-PowerShell-Dateien.

    Erforderliche Rolle: Administrator

    Prozedur

    1. Navigieren zu Alle > MID-Server > Eigenschaften.
    2. Legen Sie mid.property.powershell.log_info auf „true“fest.
      Diese Eigenschaft aktiviert oder deaktiviert die Protokollierung. Weitere Informationen finden Sie unter PowerShell-Protokolleigenschaft.
    3. Legen Sie mid.property.powershell.ih.log_level auf die gewünschte Protokollebene fest.
      Die Protokollebene gibt den Schwellenwert an, der zum Protokollieren einer Nachricht erforderlich ist. Nachrichten werden ab der angegebenen Ebene protokolliert. Wenn diese Eigenschaft beispielsweise auf WARN festgelegt ist, werden Nachrichten mit der Stufe WARN oder FEHLER protokolliert. Nachrichten mit den Stufen „INFO“, „DEBUG“ oder „TRACE“ werden nicht protokolliert. Die Ebenen sind, von niedrig nach hoch, aufgelistet:
      • TRACE
      • DEBUG
      • INFO
      • WARN
      • FEHLER
      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 > Eigenschaften.
      2. Suchen Geben Sie die Protokollebene der Systemprotokolleinträge an, die im Flow-Protokoll repliziert werden sollen. Das System repliziert nur Protokolleinträge ab der angegebenen -Ebene und legt sie auf INFO oder DEBUGfest.

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

      Dieser Schritt legt die Eigenschaft com.glide.hub.flow_engine.listener_trace.threshold fest. Die Protokolle werden in der Tabelle „Flow-Engine-Protokolleinträge“ [sys_flow_log] repliziert.

    5. Fügen Sie in Ihrem PowerShell-Skript Protokollnachrichten und -ebenen mit der Funktion Write-SNCLog hinzu.
      Tabelle : 1. Write-SNCLog-Funktion und -Parameter
      Name Beschreibung
      Write-SNCLog -Funktion Protokollieren Sie eine Nachricht für den PowerShell-Schritt. Write-SNCLog verfügt über die beiden Parameter -Level und -Message. Beide Parameter sind erforderlich, die Parameternamen jedoch nicht. Wenn die Namen weggelassen werden, wird die Position verwendet, um die Ebene und die Nachricht zu bestimmen. Beispiele:
      • Write-SNCLog -Level-WARNUNG -Meldung „Protokollwarnung“
      • Write-SNCLog WARN „Protokollwarnung“
      Beide Beispiele protokollieren WARN: protokollieren Warnung.
      -Level Parameter Geben Sie die Ebene für die Protokollnachricht an. Gültige Werte sind:
      • FEHLER
      • 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. Erstellen Sie Ihre Aktion oder Ihren Flow weiter, testen Sie sie dann, und führen Sie sie dann 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 MID-Server-Dateien herunterladen.

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