---
sourceDocument: Australien Workflow Data Fabric
sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/australia/integrate-applications

 Release :

    - australia

ft:locale :

    - de-DE

ft:publication_title :

    - Australien Workflow Data Fabric

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# PowerShell-Aktivitäten

# PowerShell-Aktivitäten {#ariaid-title1}

Freigeben Version: Australia  
Aktualisiert 12. März 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer  
PowerShell basiert auf dem Windows .NET Framework und wurde entwickelt, um die Verwaltung von Windows Computern und Anwendungen zu steuern und zu automatisieren.

PowerShell muss auf jedem MID-Server installiert werden, der diese Aktivitäten verwendet. MID-Server mit PowerShell müssen auf einem unterstützten Windows Betriebssystem installiert sein. ServiceNow Unterstützt PowerShell 3,0 bis 5,1.{#c_OrchestrPowerShellActivities__ph_Supported_PowerShell_Versions}

Das ServiceNow [Orchestration-](https://www.servicenow.com/docs/ONd6qSAzBj5cqO4mbKzlPw "Verwenden Sie Orchestration Aktivitäten in einer Workflow , um sie in Drittparteisysteme zu integrieren.") Plugin fügt diese grundlegenden PowerShell-Aktivitäten Workflows hinzu. Anweisungen zur Verwendung von Aktivitäten aus dem PowerShell-Aktivitätspaket finden Sie unter [PowerShell-Aktivitätspaket](https://www.servicenow.com/docs/6W3tSCHCQ7A0dNiNhchcJw "PowerShell basiert auf dem Windows .NET Framework und wurde entwickelt, um die Verwaltung von Windows Computern und Anwendungen zu steuern und zu automatisieren.")

## Veraltete PowerShell-Aktivität ausführen {#ariaid-title2}

Die Aktivität „PowerShell ausführen" führt Windows PowerShell-Befehle auf einem MID-Server aus.
Wichtig:  
Diese Aktivität ist veraltet und für neue Workflows nicht verfügbar. Um die Funktionalität dieser Aktivität zu ersetzen, verwenden Sie die [Powershell-Aktivitätsvorlage](https://www.servicenow.com/docs/KLI65jKUX2h3se7uhe78Ew#t_CreateAPowershellActivity "Erstellen Sie eine anwenderdefinierte PowerShell-Aktivität, geben Sie Daten von einem Host mit Microsoft PowerShell an einen Workflow zurück.") , um eine anwenderdefinierte, bereichsbezogene Aktivität zu erstellen. Workflows aus einem vorherigen Release, die die Aktivität „PowerShell ausführen" verwenden, können dies weiterhin tun.

### Ergebniswerte

Der Workflow-Designer kann einen Ergebniswert mithilfe von „activity.result" aus einem Skriptfeld der Aktivität zuweisen. Standardmäßig bestimmt der Erfolg oder Fehler der verwendeten PowerShell-Befehle den Ergebniswert der Aktivität „PowerShell ausführen". Mögliche Ergebniswerte sind:

* Erfolg
* Fehler
{#r_RunPowershellActivity__ul_oqc_yxs_hp}

### Scratchpad-Einträge

Informationen, die <var class="keyword varname"></var> vom ausführenden Skript in stdout geschrieben wurden, werden erfasst und an die Aktivität in der<var class="keyword varname"></var> Variable „activity.output" zurückgegeben. Diese Informationen können analysiert, verarbeitet oder gespeichert werden (z. B. in einer Scratchpad-Variable), um sie in Zukunft im Sensorskript der Aktivität zu verarbeiten.  
Ein Beispiel wäre die Ausführung des Befehls „get-date", um die aktuelle Uhrzeit des MID-Servers abzurufen. Dieses Sensorskript speichert die gesamte empfangene Ausgabe, aber wir können sie so verarbeiten, dass sie zurückgegeben wird und nur die Zeit gespart wird.Abbildung : 1. PowerShell-Aktivität  
Hinweis:  
Dies ist ein zu vereinfachtes Beispiel. In den meisten Fällen funktioniert das Skript für einen Remotecomputer Windows . Der Prinzipal ist jedoch derselbe -- alles, was in `stdout geschrieben` wird, wird in „ `activity.output` " zurückgegeben und kann verarbeitet werden.

### Eingabevariablen

{#r_RunPowershellActivity__table_kh2_mys_hp__entry__2}

| Feld | Beschreibung |
|-|-|
| Hostname | IP-Adresse des Zielcomputers Windows . Dieser Wert ist der <var class="keyword varname"></var> Variable $Computer zur Verwendung in Befehlen zugeordnet (siehe Beispiel im Feld Befehl). Eine PowerShell-Anmeldeinformationsvariable namens <var class="keyword varname">$cred</var> , die auf Informationen in der ServiceNow Tabelle „Anmeldeinformationen" basiert, authentifiziert sich auf dem Computer, auf den der Hostname verweist. |
| Befehl | Geben Sie den auszuführenden PowerShell-Befehl ein. Um beispielsweise eine einfache WMI-Abfrage für einen Remotecomputer auszuführen <var class="keyword varname"></var> , auf den die Hostnamenvariable verweist, lautet der Befehl: get-wmiobject <class> -computer $computer -credential $cred Wenn sich auf dem Computer keine Anmeldeinformationen authentifizieren, wird der Befehl im Kontext des MID-Server-Anwenders ausgeführt. Sie können nicht sowohl einen Befehl als auch eine Skriptdatei ausführen. Durch Angabe eines Befehls wird die <var class="keyword varname">Skriptdateivariable ausgeblendet</var> . |
| Sensorskript | Das Skript, das mit den Ergebnissen der Probe ausgeführt werden soll. Die Ausgabe der Probe ist in einer Variablen enthalten, die als <var class="keyword varname">„Ausgabe</var>" bezeichnet wird. Jeder Fehler aus der Probe ist in einer Variablen enthalten, die als <var class="keyword varname">Fehler bezeichnet wird</var>. |
| Skriptdatei | Die [Aktivieren Sie die Skriptdateisynchronisierung für Windows Verbesserte Sicherheit](https://www.servicenow.com/docs/access?context=mid-server-script-attach&version=australia&pubname=australia-servicenow-platform&section=c_EnableScriptFileSyncWinESecure&ft:locale=en-US). Sie können nicht sowohl eine Skriptdatei als auch einen Befehl ausführen. Wenn Sie eine Skriptdatei auswählen, wird die <var class="keyword varname">Befehlsvariable ausgeblendet</var> . |
| PowerShell-Skriptvariablen | Zusätzliche Parameter im JSON-Format, die von der angegebenen Skriptdatei verwendet werden. |
[Tabelle : 1. Eingabevariablen]

{#r_RunPowershellActivity__table_kh2_mys_hp}

### Status

Der Aktivitätsstatus teilt der Workflow-Engine mit, was mit der Aktivität zu tun ist.{#r_RunPowershellActivity__table_zvx_mzs_hp__entry__2}

| Status | Beschreibung |
|-|-|
| Wird ausgeführt | Die Workflow-Engine weiß, dass die onExecute- Funktion der Aktivität gestartet werden muss. |
| Abgeschlossen | Die Ausführung der Aktivität wurde abgeschlossen. Zeigen Sie den Ergebniswert für das Ergebnis der Aktivität an. |
| Abgebrochen | Diese Aktivität oder der Workflow, der diese Aktivität enthält, wurde abgebrochen. |
[Tabelle : 2. Status]

{#r_RunPowershellActivity__table_zvx_mzs_hp}  
Fügen Sie Workflow-Variablen für die Befehlszeile mithilfe der normalen Workflow-Variablensyntax hinzu. Wenn sich der \<class\> im obigen Beispiel in einer Workflow-Eingabevariable namens <var class="keyword varname">„myclass“ befand</var>, würde der Befehl wie folgt aussehen:

    get-wmiobject $ {workflow. inputs. myclass } -computer $computer --credential $cred
    Similarly  if the variable  is a scratchpad variable named myclass , the command would look like :
    get -wmiobject $ {workflow. scratchpad. myclass } -computer $computer --credential $cred

## HRESULT-Codes {#ariaid-title3}

Wenn bei einem PowerShell-Skript ein Fehler auftritt, gibt der Windows-Computer möglicherweise einen HRESULT-Code als Teil der Fehlermeldung zurück.

PowerShell-Aktivitäten können diesen Code lesen und interpretieren. Nicht alle PowerShell-Fehler enthalten einen HRESULT-Code. Im Falle eines fehlgeschlagenen PowerShell-Skripts können Sie den HRESULT-Code verwenden, um den Workflow durch eine bestimmte Bedingung zu verschieben.

Wenn Sie beispielsweise ein Active Directory-Passwort auf ein Passwort zurücksetzen, das die Richtlinienanforderungen, z. B. Mindestlänge oder Komplexität, nicht erfüllt, gibt das PowerShell-Skript den HRESULT-Code 2146022651 zurück. Um diesen Code zu verwenden, erstellen Sie eine Aktivitätsbedingung mit dem Bedingungswert „ <var class="keyword varname">activity.hresult“ = 2146022651</var>. Wenn das PowerShell-Skript diesen Code zurückgibt, wenn die Aktivität ausgeführt wird, durchläuft der Workflow diese neue Bedingung.

