Kör .Net-skript

Viktigt

Den här versionen av Orchestrator har nått slutet av supporten, vi rekommenderar att du uppgraderar till Orchestrator 2019.

Aktiviteten Kör .Net Script kör skript som skrivits i VB.NET, JScript, C# och Windows PowerShell. Den här aktiviteten är kompatibel med .NET CLR version 2.0 och senare. Använd aktiviteten Microsoft System Center – Orchestrator Kör .Net-skript för att köra skript som parsar data eller kör funktioner mot tillgängliga API:er.

Konfigurera aktiviteten Kör .Net-skript

Innan du konfigurerar aktiviteten Kör .Net-skript måste du fastställa följande:

  • Den kod som du vill köra.

  • De bibliotek som du vill använda.

  • De data som du vill publicera.

    Använd följande information för att konfigurera aktiviteten Kör .Net-skript.

Anteckning

Du kan inte ange enskilda säkerhetsautentiseringsuppgifter för den här aktiviteten. Den körs under tjänstkontot som konfigurerats för Runbook Service på Runbook-servern där instansen av aktiviteten körs. Det här kontot måste ha behörighet att komma åt resurserna och utföra de åtgärder som krävs av den här aktiviteten.

Fliken Information

Inställningar Konfigurationsanvisningar
Typ Välj skriptspråket. Använd knappen med tre punkter (...) för att bläddra efter språket.
Skript Skriv den kod som ska köras när aktiviteten körs.

Fliken Avancerat

Inställningar Konfigurationsanvisningar
Namnområde Lägg till ett namnområde för varje .NET-namnområde som ska användas i koden. På så sätt kan du anropa koden utan att använda fullständigt kvalificerade namn för var och en av klasserna. Orchestrator rekommenderar att du lägger till systemnamnrymd i varje Run .Net Script-aktivitet.
Referenser Lägg till alla sammansättningsreferenser (DLL) som innehåller de bibliotek som du vill använda. Lägg till System.dll som finns i katalogen Windows\Microsoft.NET\Framework\<.NET Version>.

Publicerade data

Lägg till de publicerade dataobjekt som du vill att den här aktiviteten ska publicera. Alla publicerade dataobjekt som du lägger till kommer att vara tillgängliga i Data bus. Det är viktigt att avgöra om ett publicerat dataobjekt kommer att ha flera värden. Aktiviteten Kör .Net-skript korrelerar automatiskt flervärdesdata från olika objekt genom att justera dem. Om du till exempel väljer att publicera två objekt med etiketten "Namn" och "E-post" som samlingar försöker kör .Net-skriptet rada upp varje objekt i samlingen Namn med varje objekt i e-postsamlingen. Om samlingarna inte är lika stora skapar aktiviteten Kör .Net-skript tomma värden för samlingen som har färre objekt. I följande publicerade datatabell visas dataobjekten och motsvarande beskrivning som publicerats av den här aktiviteten.

Fliken Publicerade data

Inställningar Konfigurationsanvisningar
Namn Ange namnet på publicerade data. Det här är det namn som visas när andra aktiviteter prenumererar på data som publiceras av aktiviteten Kör .Net-skript.
Typ Du kan välja Datum/tid, Heltal eller Sträng. Om den typ du vill använda inte är tillgänglig väljer du Sträng. Använd ToString-metoden för aktiviteten för att tilldela ett värde till dessa publicerade data.
Samling Om dina data är flervärdesdata väljer du Samling. När du använder en samling måste du använda metoden Lägg till för att lägga till objekt i samlingen. Om du inte använder samlingen kan du använda tilldelningsoperatorn (=) för att tilldela värdet.
Variabelnamn Använd unik namngivning för att se till att variabelnamnet inte krockar med befintliga variabler i skriptet eller med klasser och nyckelord som är tillgängliga i .NET. Vi rekommenderar att du prefixar variabler med "OPD_". Om du till exempel vill ge variabeln namnet "myString" skulle du ge den namnet "OPD_myString".

Aktiviteten Kör .Net-skript skapar automatiskt en .NET-egenskap för det här objektet. Om den här variabeln är en samling skapas den med hjälp av en ListT<>, där T är den typ som du har valt. Men om det inte är en samling skapas egenskapen med hjälp av en Sträng, Heltal eller Datum/tid baserat på den typ som du har valt.

Publicerade data

Objekt Beskrivning
Standardfel Standardfelutdata som publiceras av aktiviteten Kör .Net-skript.
Namnrymder De namnrymder som används.
Standardutdata Standardutdata som publiceras av aktiviteten Kör .Net-skript.
Referenser Sammansättningarna som används i aktiviteten.
Skripttext Skriptet som kördes.
Skriptspråk Det språk som valdes för skriptet.

Köra 64-bitars PowerShell-cmdletar med aktiviteten Kör .NET-skript

Du kan köra 64-bitars Windows PowerShell i aktiviteten Orchestrator Run.Net Script. Gör så här:

  1. Skapa en Run .Net Script-aktivitet från gruppen System-aktiviteter.

  2. I DetailsType> väljer du PowerShell som språk.

  3. I Skript omger du dina PowerShell-kommandon i följande kod:

    Invoke-Command -ScriptBlock {YOUR CODE} -ComputerName localhost
    
    
  4. Klicka på Finish.

    .Net Script Activity

Anteckning

Om du vill verifiera PowerShell-versionen använder du följande skript i Aktiviteten Kör .Net-skript och publicerar variabeln 64-bitars och PowerShell-version.


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

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

View .Net Script Activity