---
sourceDocument: Xanadu: Integrationen mit Anwendungen erstellen
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/integrate-applications

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu: Integrationen mit Anwendungen erstellen

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Konfigurieren Sie die Protokollierung für den PowerShell-Schritt

# Konfigurieren Sie die Protokollierung für den PowerShell-Schritt {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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](https://www.servicenow.com/docs/access?context=mid-server-powershell-files&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US).

Erforderliche Rolle: admin

## Prozedur

1. Navigieren zu AlleMID-ServerEigenschaften.
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](https://www.servicenow.com/docs/access?context=powershell-log-property&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US).
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
   {#configure-logging-powershell-step__ul_d53_2b1_jtb}Der Standardwert ist INFO.
4. **Wahlweise:** Konfigurieren Sie eine Systemeigenschaft, damit Sie die Protokolle in der -Instanz anzeigen können.
   1. Navigieren zu AlleProzessautomatisierungFlow DesignerEigenschaften.
   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.

   {#configure-logging-powershell-step__substeps_imq_42q_jyb}  
   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.  
   {#configure-logging-powershell-step__table_pxf_3lj_dtb__entry__2}

   | 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"` {#configure-logging-powershell-step__ul_cn4_jnj_dtb}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 {#configure-logging-powershell-step__ul_vpj_wns_gtb}Dieser Parameter ist erforderlich. |
   | -Message Parameter | Geben Sie die zu protokollierende Nachricht an. Als Zeichenfolge eingegeben. Dieser Parameter ist erforderlich. |
   [Tabelle : 1. Write-SNCLog-Funktion und -Parameter]

   {#configure-logging-powershell-step__table_pxf_3lj_dtb}
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](https://www.servicenow.com/docs/access?context=t_DownloadMIDServerFiles&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US).

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](https://www.servicenow.com/docs/access?context=flow-execution-details&version=xanadu&pubname=xanadu-build-workflows&ft:locale=en-US).
**Zugehörige Tasks**   

* [Testen Sie Anmeldeinformationen für den PowerShell-Schritt](https://servicenow-prod.fluidtopics.net/Spva1TNZT00wd6tWXc7JRA "Testen Sie im PowerShell-Schritt konfigurierte Anmeldeinformationen. Stellen Sie sicher, dass die Anmeldeinformationen funktionieren, bevor Sie den Rest Ihres Schritts erstellen.")

