--- sourceDocument: Yokohama Now Platform-Fähigkeiten sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/servicenow-platform Release : - yokohama ft:locale : - de-DE ft:publication_title : - Yokohama Now Platform-Fähigkeiten ft:clusterId : - platcap bundleId : - platcap workflow : - Platform --- # PowerShell-Dateien des MID-Servers # PowerShell-Dateien des MID-Servers {#ariaid-title1} * Freigeben Version: Yokohama * * Aktualisiert 30. Januar 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer PowerShell-Funktionen werden in Skriptdateien (\*.ps1) gespeichert, die eine PowerShell-Skriptmodul-Dateinamenerweiterung (\*.psm1) verwenden. Die PowerShell-Funktionen werden von den PowerShell-MID-Server-Skriptdateien verwendet, die in diesen Aktivitätspaketen enthalten sind: * Active Directory * Austauschvorgang * SCCM * PowerShell {#mid-server-powershell-files__ul_gd5_554_cw} ## PSScript.ps1 Dieses Skript führt einige Aufgaben aus, z. B. Tests von Anmeldeinformationen, Passwortverschlüsselung und die Ausführung von Skripts, die im Orchestration-Aktivitätendesigner oder in MID-Skriptdateien konfiguriert sind. Dieses Dokument konzentriert sich jedoch darauf, wie PSScript.ps1 verwendet Credential.psm1 Modul zum Testen des Zugriffs auf Remote-Hosts. Die PowerShell-Variablen werden im Allgemeinen direkt in verwendet [PowerShell-Ausführungsbefehl](https://servicenow-prod.fluidtopics.net/U7vfL6CjuCzOMbAvRE5jqQ#t_MapPowershellVariablesToExecCmd "Verwenden Sie die von Ihnen erstellten Eingabevariablen, um den Befehl zu konfigurieren, den Orchestration auf dem Windows-Zielcomputer ausführt.")Oder als Argumente in der von Ihnen angegebenen MID-Server-Skriptdatei. Es gibt spezielle Variablen, die an PSScript.ps1 übergeben werden, z. B. credType. Abbildung : 1. CredType wird in Ausführungsparametern verwendet ## PowerShell-credTypes Die PowerShell-Anmeldeinformationstypen: {#mid-server-powershell-files__table_pm5_b1p_cw__entry__2} | Typ | Beschreibung | |-|-| | WMI | TestAnmeldeinformationsWMI | | Austauschvorgang | TestCredentilExchange | | AD | TestAnmeldeinformationen | | SCCM | TestAnmeldeinformationsSCCM | [ ] {#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. ## Exit-Codes Diese Exit-Codes 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 erfolgreich ausgeführt. | | 1 | Test erfolgreich abgeschlossen, Befehl/Skript konnte jedoch nicht ausgeführt werden. | | 2 | Falsche Syntax an Skript übergeben. | | 3 | Alle Anmeldeinformationen, einschließlich des MID-Server-Service-Accounts, konnten den Befehl/das Skript nicht ausführen. | | 4 | Hat den Test bestanden und die Aktivität ausgeführt, es wurde jedoch ein Fehler zurückgegeben. Beispielanwender wurde nicht gefunden. | [Tabelle : 1. PSScript.ps1-Exit-Codes] {#mid-server-powershell-files__table_r4l_n5q_dw} ## DiagnoseUtil.psm1 {#mid-server-powershell-files__section_rd2_vkl_4bb} Der MID-Server verwendet diese Moduldatei, um eine PowerShell-Protokollierung durchzuführen, die das Debugging von Orchestration-Aktivitäten mithilfe von PowerShell-Skripting unterstützt. Sie können Debugging-Anweisungen auch direkt zu anwenderdefinierten Skripts hinzufügen.{#mid-server-powershell-files__table_sd2_vkl_4bb__entry__2} | Dienstprogramm | Beschreibung | |-|-| | SNCLog-DebugInfo | Protokollieren Sie eine Debug-Nachricht für ein PowerShell-Skript oder eine PowerShell-Orchestration-Aktivität. Beispiele: * `SNCLog-DebugInfo: Nachricht „meine Debug-Nachricht..."` * `SNCLog-DebugInfo „meine Debug-Nachricht"` {#mid-server-powershell-files__ul_qw4_knl_4bb} | | SNCLog-ParameterInfo | Protokollieren Sie einen Funktionsparameterwert. Für `„Funktion getHostName{ param( [Zeichenfolge] $target )" `, Der erste Wert für die PowerShell-Hashtabelle ist eine Zeichenfolge, die angibt, welche Funktion ausgeführt wird, und die Werte für jeden der Funktionsparameter. Beispiele: * Funktion mit einzelnem Parameter: `SNCLog-ParameterInfo @(„getHostName wird ausgeführt", $target) ` Hinweis: Die Debug-Nachricht wird angezeigt: „ `GetHostName $target wird ausgeführt:[ist-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 zu Sicherheitszwecken zu verschlüsseln. Die Funktion wird angezeigt `„$variableName":*** `, Wobei \*\*\* der verschleierte Wert ist. Beispiel: `SNCObfuscate-value $password` Hinweis: Die Debug-Nachricht lautet: `„$password: ***" `. | [Tabelle : 2. PowerShell-Diagnosedienstprogramme] {#mid-server-powershell-files__table_sd2_vkl_4bb} ## Anmeldeinformationen.psm1 Der MID-Server verwendet diese Moduldatei, um den Zugriff auf einen Zielhost zu testen. Der MID-Server durchläuft alle WindowsAnmeldeinformationen, die in der Anmeldeinformationstabelle mit den folgenden Zugriffstypfunktionen gespeichert sind, es sei denn, die PowerShell-Aktivität hat einen Anmeldeinformationstyp ( CredType ) Definiert. Alle ServiceNow®Erstellte PowerShell-Aktivitäten sind hartcodiert, um einen bestimmten Anmeldeinformationstyp zu verwenden. Daher testet der MID-Server nur den Anmeldeinformationszugriff anhand der angegebenen Funktion.{#mid-server-powershell-files__table_qmm_z1p_cw__entry__2} | Funktion | Beschreibung | |-|-| | TestAnmeldeinformationsWMI | Testet den angegebenen Anwender und das angegebene Passwort auf dem Zielhost mit Get-WMIObjekt. | | TestAnmeldeinformationen | Testet den angegebenen Anwender und das angegebene Passwort auf dem Zielhost mit dem integrierten DirectoryEntryObjekt. | | TestCredentialExchange | Testet den angegebenen Anwender und das angegebene Passwort, um eine Sitzung auf einem Exchange-Host zu erstellen. Dieser Test verwendet die integrierte PowerShell-Remotingfunktion auf einem Remote-Host. WinRM ist standardmäßig auf Exchange-Servern konfiguriert. | | TestAnmeldeinformationsSCCM | Testet den angegebenen Anwender und das angegebene Passwort, um eine Sitzung auf einem SCCM-Server zu erstellen. Dieser Test verwendet die integrierte PowerShell-Remotingfunktion auf einem Remote-Host. Dieser Test erfordert die Konfiguration von WinRM. | | TestNoCredentialAccessWMI | Testet den angegebenen Anwender und das angegebene Passwort auf dem Zielhost mit Get-WMIObjekt. Dieser Test wird verwendet, wenn nicht CredType Wird verwendet. | [Tabelle : 3. PowerShell-Testfunktionen] {#mid-server-powershell-files__table_qmm_z1p_cw} Hinweis: Wenn der Test mit einer dieser Funktionen erfolgreich ist, werden diese Anmeldeinformationen zum Ausführen des PowerShell-Skripts/Befehls verwendet. Wenn die Tests mit diesen Funktionen nicht auf den Zielhost zugreifen können, führt der MID-Server das PowerShell-Skript/-Befehl unter dem Account des MID-Serverservice aus. Dieses Diagramm veranschaulicht die Abhängigkeit des Verhaltens der Anmeldeinformationsauswahl auf dem Host, der von der PowerShell-Aktivität angestrebt wird. 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-Serverservice. Wenn der Zielhost nicht der MID-Server ist, dann alle WindowsAnmeldeinformationen werden zuerst verwendet. Wenn alle Anmeldeinformationen in der Tabelle „Anmeldeinformationen" die PowerShell-Aktivität nicht erfolgreich ausführen können, verwendet der MID-Server den MID-Server-Service-Account. Abbildung : 2. Auswahlkriterien für PowerShell-Anmeldeinformationen ## ActiveDirectory.psm1 Diese Moduldatei speichert die Funktionen, die von den mit dem gelieferten PowerShell-Skripts verwendet werden [Active Directory](https://servicenow-prod.fluidtopics.net/KFkX9ul4kh1MBk5iyakpxQ "Mit dem Active Directory (AD)-Aktivitätenpaket kann ein Administrator Objekte in Windows Active Directory erstellen, löschen und verwalten, z. B. Anwender, Gruppen und Computer, mithilfe eines ServiceNow-Orchestration-Workflows.")Aktivitätspaket. ## Exchange.psm1 Diese Moduldatei speichert die Funktionen, die von den mit dem gelieferten PowerShell-Skripts verwendet werden [Austausch](https://servicenow-prod.fluidtopics.net/yOnW8nequcs79ZS0riTQnA "Mit dem Exchange-Aktivitätenpaket können Workflows verwaltet werden MicrosoftMicrosoft Azure Event HubsExchange-E-Mail-Systeme.")Aktivitätspaket. ## SCCM.psm1 Diese Moduldatei speichert die Funktionen, die von den mit dem gelieferten PowerShell-Skripts verwendet werden [SCCM](https://servicenow-prod.fluidtopics.net/s3lCuIqcIRJgeoyti7yVDg "Das Aktivitätenpaket „Microsoft Systemcenter-Konfigurationsverwaltung (SCCM)“ bietet Orchestrationsaktivitäten, die Sie zum Verwalten von Softwarebereitstellungen und -Sammlungen auf einem SCCM-Server verwenden können.")Aktivitätspaket.