Power Shell-Befehl

Mit der Aktion PowerShell-Befehl wird ein Windows PowerShell-Befehl durchgeführt.

Auf den folgenden Registerkarten können Sie die Eigenschaften für die Aktion PowerShell-Befehl konfigurieren.

Registerkarte „PowerShell-Befehl“

Befehl

Quelle:Gibt den Quelle für den Befehl an, der gesendet wird.
- Eingebettete Befehle:
- Variable:
  - Variable: Geben Sie die Variable ein, die Sie für die Quelle verwenden möchten. Alternativ können Sie auch auf eine kürzlich verwendete Variable oder auf Weitere Variablen klicken, um das Dialogfeld Variable einfügen zu öffnen.
- Externe Datei:
  - Position: Gibt das Dateisystem an, in dem der Quellenordner vorliegt. Die Dateisysteme oder Speicherorte können lokale Dateisysteme oder Netzwerkfreigaben, Librarian oder einen unterstützten Cloud-Speicherort umfassen. Weitere Informationen über unterstützte Cloud-Speicherorte finden sie auf der Administration Console Seite „Cloud-Speicher“.
  - Dateiname: Legt den Dateipfad fest. Sie können den Speicherort des Ordners und den Dateinamen eingeben oder auf Durchsuchen klicken, um zur gewünschten Datei zu navigieren und diese auszuwählen. Alternativ können Sie eine Variable hinzufügen, um die Datei anzugeben, oder ein Sonderzeichen zum eingegebenen Wert hinzufügen.
  - Dateicodierung: Legt die Codierung fest, die von der Quelldatei verwendet wird.
Als Batch ausführen: Gibt an, dass die angegebene Datei als Batch-Datei ausgeführt wird. Verfügbar, wenn der Wert der Datenquelle auf Externe Datei und der Wert des Speicherorts auf Computer/Netzwerk eingestellt ist.
- Parameter: Gibt die Parameter an, die an die Batch-Datei übermittelt werden. Verfügbar, wenn Als Batch ausführen ausgewählt ist.
Warten, bis Befehl abgeschlossen ist: Der Befehl wird erst nach Erhalt einer Antwort ausgeführt. Wenn diese Option nicht ausgewählt ist, wird der Befehl ausgeführt, ohne dass auf eine Antwort gewartet wird.
- Zeitüberschreitung bei Ausführung (Sekunden): Gibt die Zeitspanne an, die die Aktion für die Ausführung des Befehls benötigt, bevor die Aktion ausläuft und beendet wird.

Ausgabe

Befehlsausgabe an Nachrichtenprotokoll senden: Nimmt die Ausgabe des Shell-Befehls in das Meldungsprotokoll auf.

Für jede der folgenden Optionen können Sie die gewünschte Variable eingeben. Alternativ können Sie eine Variable hinzufügen.

Ausgegebene Befehle und Fehler in Variable speichern: Legt die Variable fest, in die die Befehlsausgabe und Fehler gespeichert werden.
Fehler bei Befehlen in Variable speichern: Legt die Variable fest, in die Fehler bei Befehlen gespeichert werden.
Befehls-Ausnahmefehler in Variable speichern: Gibt die Variable an, in der Ausnahmefehler bei Befehlen gespeichert sind.

Registerkarte ,Aktion‘

Aktion

Name: Gibt den Namen der Aktion an. Sie können den Standardnamen ersetzen, indem Sie einen neuen Namen in das Feld eintragen.
Beschreibung: Gibt eine Beschreibung für die Aktion an.
Aktion ausführen: Legt fest, wie oft die Aktion ausgeführt werden soll.
- Immer: Legt fest, dass der Integrationsdienst die Aktion bei jeder Durchführung der Integration ausführt.
- Nie: Legt fest, dass der Integrationsdienst die Aktion bei der Durchführung der Integration nicht ausführt.
- Bedingt, auf Variable basierend: Legt fest, dass der Integrationsdienst die Aktion nur dann ausführt, wenn eine ausgewählte Variable eine bestimmte Bedingung erfüllt. Nutzen Sie diese Option in Situationen, in denen nur eine Bedingung vorhanden ist, die bestimmt, ob die Aktion durchgeführt wird. Nachdem Sie diese Option ausgewählt haben, können Sie die bedingte Anweisung im Eingabefeld erstellen.
  
  Bedienelemente im Eingabefeld
  - Variable: Gibt die Variable an, die für die bedingte Anweisung verwendet werden soll. Geben Sie die Variable in das Eingabefeld ein. Klicken Sie , um eine Liste der zuletzt verwendeten Variablen anzuzeigen, oder klicken Sie auf Weitere Variablen, um das Dialogfeld Variable einfügen zu öffnen.
  - [Relationaler Operator]: Gibt den relationalen Operator zur Verwendung für die bedingte Anweisung an. Klicken Sie auf den bestehenden Operator, um eine Liste zusätzlicher Operatoren zu öffnen, und wählen Sie den gewünschten aus. Weitere Informationen finden Sie unter Relationale Operatoren. Welche Operatoren in der Liste verfügbar sind, hängt davon ab, ob Sie für die Option Typ den Eintrag Text oder Dezimal ausgewählt haben.
  - Wert: Gibt den oder die Werte zur Verwendung für die bedingte Anweisung an. Um einen Wert hinzuzufügen, klicken Sie auf und auf <Wert eingeben>. Geben Sie den gewünschten Wert ein und drücken Sie dann Enter. Um einen Wert zu löschen, klicken Sie mit der sekundären Maustaste darauf und klicken Sie dann auf Löschen. Bei manchen Operatoren wie Is blank (ist leer) und Is not blank (ist nicht leer) muss kein Wert angegeben werden. In diesen Fällen ist das Feld Wert nicht verfügbar.
  - Typ: Legt fest, ob die bedingte Anweisung einen Text oder einen Dezimalwert auswertet.
- Bedingt, abhängig von Ausdruck: Legt die Bedingungen fest, unter denen der Integrationsdienst die Aktion ausführt. Nutzen Sie diese Option in Situationen, wo mehrere bedingte Anweisungen benötigt werden. Wenn Sie diese Option wählen, können Sie den bedingten Ausdruck im Eingabefeld erstellen, indem Sie die gewünschten bedingten Anweisungen eingeben. Ein bedingter Ausdruck wird auf der Registerkarte Strukturansicht erstellt und bearbeitet. Klicken Sie auf die Registerkarte Textansicht, um eine schreibgeschützte Textansicht des bedingten Ausdrucks aufzurufen.
  
  Bedienelemente im Eingabefeld (Registerkarte „Strukturansicht“)
  - [Bedingter Verbinder]: Gibt den bedingten Verbinder für die bedingten Anweisungen innerhalb der Gruppe an. Der bedingte Verbinder And (Und) ist voreingestellt.
    
    Klicken Sie auf den bestehenden bedingten Verbinder, um ein Menü aufzurufen, in dem Sie Ihren bedingten Ausdruck mit einem der folgenden Verfahren konfigurieren können:
    - And (Und), Or(Oder), NotAnd(Nicht Und), NotOr(Nicht Oder): Klicken Sie auf den bedingten Verbinder in der Liste, den Sie für die bedingten Anweisungen verwenden möchten. Weitere Informationen über die unterstützten bedingten Verbinder finden Sie unter Bedingte Verbinder.
    - Bedingung hinzufügen: Klicken Sie hierauf, um eine weitere bedingte Anweisung zur aktuellen Gruppe hinzuzufügen.
    - Gruppe hinzufügen: Klicken Sie hierauf, um eine Untergruppe mit bedingten Anweisungen zur aktuellen Gruppe hinzuzufügen.
    - Gruppe entfernen: Klicken Sie hier, um die Untergruppe zu löschen. Verfügbar, wenn Sie das Menü aus einer Untergruppe heraus öffnen.
    - Alle löschen: Klicken Sie hierauf, um alle bedingten Anweisungen (einschließlich der Untergruppen) zu löschen. Verfügbar, wenn Sie das Menü von der obersten Gruppe aus öffnen.
  - : Fügt zu der Gruppe, die dem jeweiligen Verbinder zugeordnet ist, eine bedingte Anweisung hinzu. Dieses Symbol wird rechts von den einzelnen bedingten Verbindern in Ihrem Ausdruck angezeigt.
  - : Löscht die bedingte Anweisung. Dieses Symbol wird rechts von einer bestehenden bedingten Anweisung angezeigt, wenn Sie auf die Anweisung zeigen.
  - Variable: Gibt die Variable an, die für die bedingte Anweisung verwendet werden soll. Geben Sie die Variable in das Eingabefeld ein. Klicken Sie , um eine Liste der zuletzt verwendeten Variablen anzuzeigen, oder klicken Sie auf Weitere Variablen, um das Dialogfeld Variable einfügen zu öffnen.
  - [Relationaler Operator]: Gibt den relationalen Operator zur Verwendung für die bedingte Anweisung an. Klicken Sie auf den bestehenden Operator, um eine Liste zusätzlicher Operatoren zu öffnen, und wählen Sie den gewünschten aus. Weitere Informationen finden Sie unter Relationale Operatoren. Welche Operatoren in der Liste verfügbar sind, hängt davon ab, ob Sie für die Option Typ den Eintrag Text oder Dezimal ausgewählt haben.
  - Wert: Gibt den oder die Werte zur Verwendung für die bedingte Anweisung an. Um einen Wert hinzuzufügen, klicken Sie auf und auf <Wert eingeben>. Geben Sie den gewünschten Wert ein und drücken Sie dann Enter. Um einen Wert zu löschen, klicken Sie mit der sekundären Maustaste darauf und klicken Sie dann auf Löschen. Bei manchen Operatoren wie Is blank (ist leer) und Is not blank (ist nicht leer) muss kein Wert angegeben werden. In diesen Fällen ist das Feld Wert nicht verfügbar.
  - Typ: Legt fest, ob die bedingte Anweisung einen Text oder einen Dezimalwert auswertet.

Anmeldeeinstellungen

Von übergeordneter Aktion übernehmen: Gibt an, dass die Aktion die auf der Eigenschaftsseite Aktionen angegebenen Anmeldeeinstellungen übernimmt. Wenn es sich bei der Aktion andererseits um eine Aktion „Gruppieren“ handelt, übernimmt sie die Anmeldeeinstellungen auf der Eigenschaftenregisterkarte der direkt übergeordneten Aktion Gruppieren.
Benutzeranmeldedaten angeben: Gibt an, dass die Aktion unter werden Verwendung der angegebenen Anmeldeeinstellungen ausgeführt wird.

Fehlerverarbeitung und Diagnose

Fehler ignorieren und mit der Ausführung von Aktionen fortfahren: Gibt an, dass bei einem Fehlschlagen der Aktion die übrigen Aktionen weiter ausgeführt werden. Wenn diese Option nicht ausgewählt wurde und die Aktion fehlschlägt, hängt das resultierende Verhalten von den folgenden Faktoren ab:

Die Aktion ist Bestandteil einer Aktion vom Typ „Gruppieren“
- Wenn Sie Der Reihe nach für die Eigenschaft Aktionen ausführen auf der Registerkarte Ausführung der Aktion Gruppieren angegeben haben, werden keine weiteren Aktionen im Rahmen der Aktion „Gruppieren“ ausgeführt. Außerhalb dieser Aktion „Gruppieren“ sind keine Aktionen betroffen.
- Wenn Sie Parallel für die Eigenschaft Aktionen ausführen auf der Registerkarte Ausführung der Aktion Gruppieren angegeben haben, werden die Fehler ignoriert und weitere Aktionen werden im Rahmen der Aktion „Gruppieren“ ausgeführt. Außerhalb dieser Aktion „Gruppieren“ sind keine Aktionen betroffen.
Die Aktion ist nicht Bestandteil einer Aktion vom Typ „Gruppieren“
- Wenn Sie Der Reihe nach für die Eigenschaft Aktionen ausführen auf der Registerkarte Ausführung der Aktion Aktionen angegeben haben, werden keine weiteren Aktionen im Rahmen der Integration ausgeführt.
- Wenn Sie Parallel für die Eigenschaft Aktionen ausführen auf der Registerkarte Ausführen der Aktion Aktionen angegeben haben, werden die Fehler ignoriert und weitere Aktionen werden im Rahmen der Integration ausgeführt.

Bei Fehlschlag erneut versuchen: Legt fest, dass bei einem Fehlschlagen der Aktion der Integrationsdienst versucht, diese erneut auszuführen.
- Maximale erneute Versuche: Legt die maximale Anzahl der Versuche durch den Integrationsdienst fest, die Aktion erneut auszuführen. Verfügbar, wenn die Option Bei Fehlschlag erneut versuchen ausgewählt wurde.
- Intervall für erneute Versuche: Legt die Zeitdauer fest, während der der Integrationsdienst nach dem Fehlschlagen der Aktion wartet, bevor er versucht, die Aktion erneut auszuführen. Verfügbar, wenn die Option Bei Fehlschlag erneut versuchen ausgewählt wurde.