Ausführen eines .NET-Skripts

Wichtig

Diese Version von Orchestrator hat das Ende des Support erreicht. Es wird empfohlen, ein Upgrade auf Orchestrator 2019 zu durchführen.

Die Aktivität .NET-Skript ausführen führt Skripts aus, die in VB.NET, JScript, C# und Windows PowerShell. Diese Aktivität ist mit .NET CLR Version 2.0 und höher kompatibel. Verwenden Sie die Aktivität Microsoft System Center – Orchestrator Run .NET Script , um Skripts auszuführen, die Daten analysieren oder Funktionen für verfügbare APIs ausführen.

Konfigurieren der Aktivität ".NET-Skript ausführen"

Bevor Sie die Aktivität .NET-Skript ausführen konfigurieren, müssen Sie Folgendes bestimmen:

  • Der Code, den Sie ausführen möchten.

  • Die Bibliotheken, die Sie verwenden möchten.

  • Die Daten, die Sie veröffentlichen möchten.

    Verwenden Sie die folgenden Informationen, um die Aktivität .NET-Skript ausführen zu konfigurieren.

Hinweis

Sie können keine einzelnen Sicherheitsanmeldeinformationen für diese Aktivität festlegen. Sie wird unter dem Dienstkonto ausgeführt, das für Runbook Service auf dem Runbook-Server konfiguriert ist, auf dem die Instanz der Aktivität ausgeführt wird. Dieses Konto muss über die Berechtigung verfügen, auf die Ressourcen zu zugreifen und die für diese Aktivität erforderlichen Aktionen durchzuführen.

Die Registerkarte „Details“

Einstellungen Konfigurationsanweisungen
Typ Wählen Sie die Skriptsprache aus. Verwenden Sie die Schaltfläche mit den Auslassungszeichen (...), um nach der Sprache zu suchen.
Skript Geben Sie den Code ein, der ausgeführt wird, wenn die Aktivität ausgeführt wird.

Erweitert (Registerkarte)

Einstellungen Konfigurationsanweisungen
Namespace Fügen Sie einen Namespace für jeden .NET-Namespace hinzu, der in Ihrem Code verwendet wird. Dadurch können Sie den Code aufrufen, ohne vollqualifizierte Namen für jede der Klassen zu verwenden. Orchestrator empfiehlt, jeder Aktivität .NET-Skript ausführen den Systemnamespace hinzufügen.
Referenzen Fügen Sie jeden der Assemblyverweise (DLL) hinzu, die die Bibliotheken enthalten, die Sie verwenden möchten. Fügen Sie System.dll im Verzeichnis Windows\Microsoft.NET\Framework\ .NET Version hinzu.

Veröffentlichte Daten

Fügen Sie die veröffentlichten Datenelemente hinzu, die diese Aktivität veröffentlichen soll. Jedes veröffentlichte Datenelement, das Sie hinzufügen, ist im Datenbus verfügbar. Es ist wichtig zu bestimmen, ob ein veröffentlichtes Datenelement mehrwertige Werte hat. Die Aktivität .NET-Skript ausführen korreliert automatisch mehrwertige Daten aus verschiedenen Elementen, indem diese ausgerichtet werden. Wenn Sie beispielsweise zwei Elemente mit der Bezeichnung Name und E-Mail als Sammlungen veröffentlichen möchten, versucht das Skript .NET ausführen, jedes Element in der Sammlung Name mit jedem Element in der Sammlung E-Mail in eine Zeile zu “”“” stellen. Wenn die Größe der Sammlungen nicht gleich groß ist, erstellt die Aktivität .NET-Skript ausführen leere Werte für die Sammlung, die weniger Elemente enthält. In der folgenden Tabelle veröffentlichte Daten sind die Datenelemente und die entsprechende Beschreibung aufgeführt, die von dieser Aktivität veröffentlicht wurden.

Registerkarte "Veröffentlichte Daten"

Einstellungen Konfigurationsanweisungen
Name Geben Sie den Namen der veröffentlichten Daten ein. Dies ist der Name, der angezeigt wird, wenn andere Aktivitäten die von der Aktivität .NET-Skript ausführen veröffentlichten Daten abonnieren.
Typ Sie können Datum/Uhrzeit,ganze Zahloder Zeichenfolge auswählen. Wenn der typ, den Sie wünschen, nicht verfügbar ist, wählen Sie Zeichenfolge aus. Verwenden Sie die ToString-Methode der Aktivität, um diesen veröffentlichten Daten einen Wert zu zuweisen.
Sammlung Wenn es sich bei Ihren Daten um mehrwertige Daten handelt, wählen Sie Sammlung aus. Wenn Sie eine Auflistung verwenden, müssen Sie die Add-Methode verwenden, um der Auflistung Elemente hinzuzufügen. Wenn Sie die Auflistung nicht verwenden, können Sie den Zuweisungsoperator (=) verwenden, um den Wert zu zuweisen.
Variablenname Verwenden Sie eindeutige Benennungen, um sicherzustellen, dass Ihr Variablenname nicht mit vorhandenen Variablen in Ihrem Skript oder mit Klassen und Schlüsselwörtern in .NET in Zusammenhang steht. Es wird empfohlen, Variablen das Präfix “” OPD_. Wenn Sie ihre Variable z. B. myString nennen möchten, geben Sie ihr den “” Namen “” OPD_myString.

Die Aktivität .NET-Skript ausführen erstellt automatisch eine .NET-Eigenschaft für dieses Element. Wenn es sich bei dieser Variablen um eine Sammlung handelt, wird sie mithilfe einer Liste T erstellt, wobei T der typ ist, <> den Sie ausgewählt haben. < Wenn es sich jedoch nicht um eine Auflistung handelt, wird die -Eigenschaft basierend auf dem ausgewählten Typ mit einer Zeichenfolge,einer ganzen Zahl oder mit Datum/Uhrzeit erstellt.

Veröffentlichte Daten

Element BESCHREIBUNG
Standardfehler Jede Standardfehlerausgabe, die von der Aktivität .NET-Skript ausführen veröffentlicht wird.
Namespaces Die verwendeten Namespaces.
Standardausgabe Die Standardausgabe, die von der Aktivität .NET-Skript ausführen veröffentlicht wird.
References Die assemblys, die in der Aktivität verwendet werden.
Skripttext Das Skript, das ausgeführt wurde.
Skriptsprache Die Sprache, die für das Skript ausgewählt wurde.

Ausführen von 64-Bit-PowerShell-Cmdlets mit der Aktivität ".NET-Skript ausführen"

Sie können 64-Bit-Windows PowerShell in Orchestrator Run.Net Script-Aktivität ausführen. Führen Sie die folgenden Schritte durch:

  1. Erstellen Sie eine Aktivität .NET-Skript ausführen aus der Gruppe Systemaktivitäten.

  2. Wählen Sie unterDetailstypdie Option PowerShell als Sprache aus.

  3. Schließen Sie ihrePowerShell-Befehle unter Skript in den folgenden Code ein:

    Invoke-Command -ScriptBlock {YOUR CODE} -ComputerName localhost
    
    
  4. Klicken Sie auf Fertig stellen.

    .Net Script Activity

Hinweis

Um die PowerShell-Version zu überprüfen, verwenden Sie das folgende Skript in der Aktivität .NET-Skript ausführen, und veröffentlichen Sie die 64-Bit- und PowerShell-Versionsvariable.


$Result = Invoke-Command -ComputerName localhost {
$Is64BitProcess = [Environment]::Is64BitProcess
$PSVersion = $PSVersionTable.PSVersion
RETURN $Is64BitProcess, $PSVersion
}

$64bit = $Result[0]
$PSVersion = $Result[1]
)

View .Net Script Activity