--- 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 --- # PowerShell-Dateien für MID Server # PowerShell-Dateien für MID Server {#ariaid-title1} * Freigeben Version: Xanadu * * Aktualisiert 1. August 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer PowerShell-Funktionen werden in Skriptdateien (\*.ps1) gespeichert, die die Dateinamenserweiterung für PowerShell-Skriptmodule (\*.psm1) verwenden. Die PowerShell-Funktionen werden von den PowerShell-Skriptdateien für MID Server verwendet, die in diesen Aktivitätspaketen enthalten sind: * Active Directory * Exchange * SCCM * PowerShell {#mid-server-powershell-files__ul_gd5_554_cw} ## PSScript.ps1 Dieses Skript führt verschiedene Aufgaben aus, wie Testen der Anmeldeinformationen, Verschlüsselung von Passwörtern und Ausführen von im Orchestration-Aktivitätsdesigner oder in MID-Skriptdateien konfigurierten Skripts. Im diesem Dokument wird jedoch hauptsächlich beschrieben, wie PSScript.ps1 mit dem Modul credential.psm1 den Zugriff auf Remote-Hosts testet. Die PowerShell-Variablen werden im Allgemeinen direkt im [PowerShell-Ausführungsbefehl](https://servicenow-prod.fluidtopics.net/MQCgLHhx1MwbZDixCnzx6w#t_MapPowershellVariablesToExecCmd "Verwenden Sie die von Ihnen erstellten Eingabevariablen, um den Befehl zu konfigurieren, den Orchestration auf dem Windows-Zielcomputer ausführt.") oder als Parameter in der von Ihnen angegebenen MID Server-Skriptdatei verwendet. Es gibt spezielle Variablen, die an PSScript.ps1 übergeben werden, z. B. credType. Abbildung : 1. credType in Ausführungsparametern verwenden ## PowerShell-credTypes PowerShell-Anmeldeinformationstypen: {#mid-server-powershell-files__table_pm5_b1p_cw__entry__2} | Typ | Beschreibung | |-|-| | WMI | testCredentialWMI | | Exchange | testCredentilExchange | | AD | testCredentilAD | | SCCM | testCredentialSCCM | [ ] {#mid-server-powershell-files__table_pm5_b1p_cw} Wenn kein Anmeldeinformationstyp an das Skript PSScrip.ps1 übergeben wird, verwendet der MID Server standardmäßig die WMI-Testfunktion, um den Zugriff auf den Zielhost zu testen. Wenn ein Anmeldeinformationstyp verwendet wird, führt der MID Server die entsprechende Testfunktion für diesen Anmeldeinformationstyp aus. ## Beendigungscodes Diese Beendigungscodes werden vom Skript PSScript.ps1 zurückgegeben und in der MID Server-Protokolldatei protokolliert. {#mid-server-powershell-files__table_r4l_n5q_dw__entry__2} | Typ | Testfunktion | |-|-| | 0 | PowerShell-Befehl/-Skript wurde erfolgreich ausgeführt. | | 1 | Der Test wurde erfolgreich abgeschlossen, aber der Befehl/das Skript konnte nicht ausgeführt werden. | | 2 | Falsche Syntax an Skript übergeben. | | 3 | Alle Anmeldeinformationen einschließlich des MID Server-Serviceaccounts konnten den Befehl/das Skript nicht ausführen. | | 4 | Test bestanden und die Aktivität ausgeführt, es wurde jedoch ein Fehler zurückgegeben. Beispielbenutzer wurde nicht gefunden. | [Tabelle : 1. PSScript.ps1-Beendigungscodes] {#mid-server-powershell-files__table_r4l_n5q_dw} ## DiagnosticsUtil.psm1 {#mid-server-powershell-files__section_rd2_vkl_4bb} Der MID Server verwendet diese Moduldatei zum Ausführen der PowerShell-Protokollierung, die das Debugging von Orchestration-Aktivitäten mithilfe von PowerShell-Skripting unterstützt. Sie können Debugging-Anweisungen auch direkt benutzerdefinierten Skripts hinzufügen.{#mid-server-powershell-files__table_sd2_vkl_4bb__entry__2} | Dienstprogramm | Beschreibung | |-|-| | SNCLog-DebugInfo | Protokolliert eine Debug-Meldung für ein PowerShell-Skript oder eine PowerShell-Orchestration-Aktivität. Beispiele: * `SNCLog-DebugInfo -message "My debug message..."` * `SNCLog-DebugInfo "My debug message"` {#mid-server-powershell-files__ul_qw4_knl_4bb} | | SNCLog-ParameterInfo | Protokolliert einen Funktionsparameterwert. Für `"function getHostName{ param( [String] $target )"` ist der erste Wert der PowerShell-Hashtabelle eine Zeichenfolge, die die ausgeführte Funktion und die Werte für jeden Funktionsparameter angibt. Beispiele: * Funktion mit einem Parameter: `SNCLog-ParameterInfo @("Running getHostName", $target)` Hinweis: Die Debug-Meldung zeigt Folgendes an: '`Running getHostName $target:[tatsächlicher Wert von $target]`'. * Funktion mit mehreren Parametern: `SNCLog-ParameterInfo @("Running functionName", $param1, $param2, $param3)` {#mid-server-powershell-files__ul_azp_p4l_4bb} | | SNCObfuscate-Value | Verwenden Sie dieses Dienstprogramm, um Werte aus Sicherheitsgründen zu verschlüsseln. Die Funktion zeigt `"$variableName":***` an, wobei \*\*\* der verschlüsselte Wert ist. Beispiel: `SNCObfuscate-Value $password` Hinweis: Die Debug-Meldung lautet: `"$password : ***"`. | [Tabelle : 2. PowerShell-Diagnosedienstprogramme] {#mid-server-powershell-files__table_sd2_vkl_4bb} ## Credentials.psm1 Der MID-Server verwendet diese Moduldatei, um den Zugriff auf einen Zielhost zu testen. Der MID-Server durchläuft alle Windows-Anmeldeinformationen, die in der Anmeldeinformationstabelle mit den folgenden Zugriffstypfunktionen gespeichert sind, es sei denn, die PowerShell-Aktivität verfügt über einen definierten Anmeldeinformationstyp (credType). Alle von ServiceNow® erstellten PowerShell-Aktivitäten sind für die Verwendung eines bestimmten Anmeldeinformationstyps hartcodiert. Daher testet der MID Server nur den Zugriff auf Anmeldeinformationen für die angegebene Funktion.{#mid-server-powershell-files__table_qmm_z1p_cw__entry__2} | Funktion | Beschreibung | |-|-| | testCredentialWMI | Testet den angegebenen Benutzer und das angegebene Passwort auf dem Zielhost mit dem Objekt Get-WMI. | | testCredentilAD | Testet den angegebenen Benutzer und das angegebene Passwort auf dem Zielhost mit dem integrierten Objekt DirectoryEntry. | | testCredentialExchange | Testet den angegebenen Benutzer und das angegebene Passwort, um eine Sitzung auf einem Exchange-Host zu erstellen. Dieser Test verwendet die integrierte PowerShell-Remoting-Funktion auf einem Remote-Host. WinRM ist standardmäßig auf Exchange-Servern konfiguriert. | | testCredentilSCCM | Testet den angegebenen Benutzer und das angegebene Passwort, um eine Sitzung auf einem SCCM-Server zu erstellen. Dieser Test verwendet die integrierte PowerShell-Remoting-Funktion auf einem Remote-Host. Für diesen Test muss WinRM konfiguriert sein. | | testNoCredentialAccessWMI | Testet den angegebenen Benutzer und das angegebene Passwort auf dem Zielhost mit dem Objekt Get-WMI. Dieser Test wird verwendet, wenn kein credType angegeben ist. | [Tabelle : 3. PowerShell-Testfunktionen] {#mid-server-powershell-files__table_qmm_z1p_cw} Hinweis: Wird der Test mit einer dieser Funktionen bestanden, wird das PowerShell-Skript/der PowerShell-Befehl mit diesen Anmeldeinformationen ausgeführt. Wenn die Tests mit diesen Funktionen nicht auf den Zielhost zugreifen können, führt der MID Server das PowerShell-Skript/den PowerShell-Befehl unter dem Account des MID Server-Service aus. Dieses Diagramm veranschaulicht die Abhängigkeit des Verhaltens von Anmeldeinformationen auf dem Zielhost der PowerShell-Aktivität. Wenn der Zielhost die IP-Adresse oder der Hostname des MID Servers ist, umgeht der MID Server alle Anmeldeinformationen in der Tabelle „Anmeldeinformationen" und verwendet den Account des MID Server-Service. Wenn der Zielhost nicht der MID Server ist, dann werden zuerst alle Windows-Anmeldeinformationen verwendet. Wenn keine der Anmeldeinformationen in der Tabelle „Anmeldeinformationen" beim Ausführen der PowerShell-Aktivität erfolgreich ist, verwendet der MID Server den MID Server-Serviceaccount. Abbildung : 2. Auswahlkriterien für PowerShell-Anmeldeinformationen ## ActiveDirectory.psm1 Diese Moduldatei speichert die Funktionen, die von den im Aktivitätspaket [Active Directory](https://www.servicenow.com/docs/access?context=c_OrchActiveDirectoryActivities&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US) enthaltenen PowerShell-Skripts verwendet werden. ## Exchange.psm1 Diese Moduldatei speichert die Funktionen, die von den im Aktivitätspaket [Exchange](https://servicenow-prod.fluidtopics.net/8TlVCxPX9iKei7a2uRbLYw "Mit dem Exchange-Aktivitätspaket können Workflows Microsoft Exchange-Mail-Systeme verwalten.") enthaltenen PowerShell-Skripts verwendet werden. ## SCCM.psm1 Diese Moduldatei speichert die Funktionen, die von den im Aktivitätspaket [SCCM](https://servicenow-prod.fluidtopics.net/NiC4L62hqOI7~m7qaWKaXg "Das Aktivitätspaket für Microsoft System Center Configuration Management (SCCM) enthält Orchestration-Aktivitäten, die Sie zum Verwalten von Softwarebereitstellungen und -sammlungen auf einem SCCM-Server verwenden können.") enthaltenen PowerShell-Skripts verwendet werden.