.Net-parancsfájl futtatásaRun .Net Script

Fontos

A Orchestrator ezen verziója elérte a támogatás végét, javasoljuk, hogy frissítsen a Orchestrator 2019-re.This version of Orchestrator has reached the end of support, we recommend you to upgrade to Orchestrator 2019.

A .net-parancsfájl futtatása tevékenység VB.NET, JScript, C# és Windows PowerShell nyelven írt parancsfájlokat futtat.The Run .Net Script activity runs scripts written in VB.NET, JScript, C#, and Windows PowerShell. Ez a tevékenység kompatibilis a .NET CLR 2,0-es vagy újabb verziójával.This activity is compatible with .NET CLR version 2.0 and later. A Microsoft System Center-Orchestrator .net-parancsfájl futtatása tevékenységgel olyan parancsfájlokat futtathat, amelyek az adatok elemzését és a függvények futtatását is használhatják az elérhető API-kkal.Use the Microsoft System Center - Orchestrator Run .Net Script activity to run scripts that parse data or run functions against available APIs.

A .net-parancsfájl futtatása tevékenység konfigurálásaConfiguring the Run .Net Script Activity

A .net-parancsfájl futtatása tevékenység konfigurálása előtt meg kell határoznia a következőket:Before you configure the Run .Net Script activity, you need to determine the following:

  • A futtatni kívánt kód.The code you want to run.

  • A használni kívánt kódtárak.The libraries you want to use.

  • A közzétenni kívánt adatértékek.The data you want to publish.

    Az alábbi információk segítségével konfigurálhatja a .net-parancsfájl futtatása tevékenységet.Use the following information to configure the Run .Net Script activity.

Megjegyzés

Ehhez a tevékenységhez nem állítható be egyedi biztonsági hitelesítő adatok.You cannot set individual security credentials for this activity. A Runbook szolgáltatáshoz konfigurált szolgáltatásfiók alatt fog futni azon a Runbook-kiszolgálón, ahol a tevékenység példánya fut.It will run under the service account configured for the Runbook Service on the Runbook server where the instance of the activity is running. Ennek a fióknak a jogosultsággal kell rendelkeznie az erőforrásokhoz való hozzáféréshez és a tevékenységhez szükséges műveletek végrehajtásához.This account must have the authority to access the resources and perform the actions required by this activity.

Részletek lapDetails Tab

BeállításokSettings Konfigurációs utasításokConfiguration Instructions
TípusType Válassza ki a parancsfájl nyelvét.Select the script language. Használja a három pont (...) gombot a nyelv megkereséséhez.Use the ellipsis (...) button to browse for the language.
ParancsfájlScript Írja be a tevékenység futásakor futtatandó kódot.Type the code that will run when the activity runs.

Speciális lapAdvanced Tab

BeállításokSettings Konfigurációs utasításokConfiguration Instructions
NévtérNamespace Adjon hozzá egy névteret minden olyan .NET-névtérhez, amelyet a kódban fog használni.Add a Namespace for each .NET namespace that will be used within your code. Ez lehetővé teszi a kód meghívását anélkül, hogy minden osztályhoz teljes nevet kellene használnia.This allows you to call the code without using fully qualified names for each of the classes. A Orchestrator javasolja a rendszernévtér hozzáadását minden .net-parancsfájl futtatása tevékenységhez.Orchestrator recommends adding System namespace to every Run .Net Script activity.
HivatkozásokReferences Adja hozzá a használni kívánt kódtárakat tartalmazó szerelvény-(DLL-) hivatkozásokat.Add each of the Assembly (DLL) references that contain the libraries that you want to use. Adja hozzá a Windows\Microsoft.NET\Framework \< .NET-verzió> könyvtárában található System.dll .Add the System.dll located in the Windows\Microsoft.NET\Framework\<.NET Version> directory.

Közzétett adatfájlokPublished Data

Adja hozzá azokat a közzétett adatelemeket, amelyeket közzé szeretne tenni a tevékenység számára.Add the published data items that you want this activity to publish. Minden hozzáadott közzétett adatelem elérhető lesz az adatbuszon.Every published data item that you add will be available on the Data bus. Fontos megállapítani, hogy egy közzétett adatelem többértékű-e.It is important to determine if a published data item will be multi-valued. A .net-parancsfájl futtatása tevékenység automatikusan összekapcsolja a különböző elemekből származó többértékű adatokat az igazítással.The Run .Net Script activity automatically correlates multi-valued data from different items by aligning them. Ha például két, "név" és "E-mail" címkével ellátott elemet tesz közzé Gyűjteményekként, a Run .net-szkript megpróbál minden elemet sorba állítani a név gyűjteményben az E-mail gyűjtemény minden elemével.For example, if you choose to publish two items labeled “Name” and “Email” as Collections, the Run .Net script will try to line up each item in the Name collection with each item in the Email collection. Ha a gyűjtemények nem azonos méretűek, a .net-parancsfájl futtatása tevékenység üres értékeket hoz létre a gyűjteményhez, amely kevesebb elemet tartalmaz.If the collections are not equally sized, then the Run .Net Script activity will create blank values for the collection that has fewer items. A következő közzétett adattábla felsorolja a tevékenység által közzétett adatelemeket és a hozzá tartozó leírást.The following Published Data table lists the data items and the corresponding description published by this activity.

Közzétett AdatlapPublished Data Tab

BeállításokSettings Konfigurációs utasításokConfiguration Instructions
NévName Adja meg a közzétett adatmennyiség nevét .Enter the Name of the published data. Ez lesz a név, amely akkor jelenik meg, ha más tevékenységek előfizetnek a .net-parancsfájl futtatása tevékenység által közzétett adatszolgáltatásra.This will be the name that appears when other activities subscribe to the data published by the Run .Net Script activity.
TípusType A dátum/idő, az egész szám vagy a sztring is kiválasztható.You can select Date/Time, Integer, or String. Ha a kívánt típus nem érhető el, válassza a karakterlánc lehetőséget.If the type you want is not available, select String. A tevékenység ToString metódusával rendeljen hozzá egy értéket a közzétett értékekhez.Use the ToString method of the activity to assign a value to this published data.
GyűjteményCollection Ha az adatai többértékű, válassza a gyűjtemény lehetőséget.If your data is multi-valued data, select Collection. Gyűjtemény használatakor az Add metódust kell használnia elemek hozzáadásához a gyűjteményhez.When using a collection, you must use the Add method to add items to the collection. Ha nem használja a gyűjteményt, akkor a hozzárendelési operátor (=) használatával rendelheti hozzá az értéket.If you are not using the collection, you can use the assignment operator (=) to assign the value.
Változó neveVariable name Egyedi elnevezéssel ellenőrizze, hogy a változó neve nem ütközik-e a parancsfájlban szereplő meglévő változókkal, illetve a .NET-ben elérhető osztályokkal és kulcsszavakkal.Use unique naming to make sure that your variable name does not collide with existing variables within your script or with classes and keywords available in .NET. Javasoljuk, hogy a változók előjavítása "OPD_" legyen.We recommend prefixing variables with “OPD_”. Ha például a "sajatString" változót szeretné átnevezni, akkor a "OPD_myString" nevet adja.For example, if you want to name your variable “myString”, you would name it “OPD_myString”.

A .net-parancsfájl futtatása tevékenység automatikusan létrehoz egy .NET-tulajdonságot ehhez az objektumhoz.The Run .Net Script activity will automatically create a .NET Property for this item. Ha ez a változó egy gyűjtemény, akkor egy listával jön létre <T> , ahol a T a kiválasztott típus .If this variable is a collection it will be created using a List<T>, where T is the Type that you selected. Ha azonban nem gyűjtemény, a tulajdonság karakterlánc, egész szám vagy dátum/idő használatával jön létre a kiválasztott típus alapján.However, if it is not a collection, the property will be created using a String, Integer, or Date/Time based on the Type that you selected.

Közzétett adatokPublished Data

ElemItem LeírásDescription
Normál hibaStandard Error A .net-parancsfájl futtatása tevékenység által közzétett szabványos hibák száma.Any standard error output published by the Run .Net Script activity.
NévterekNamespaces A használt névterek.The namespaces used.
Standard kimenetStandard Output A .net-parancsfájl futtatása tevékenység által közzétett standard kimenet.The standard output published by the Run .Net Script activity.
HivatkozásokReferences A tevékenységben használt szerelvények.The Assemblies used in the activity.
Parancsfájl törzseScript Body A futtatott parancsfájl.The script that was run.
ParancsnyelvScript Language A parancsfájlhoz kiválasztott nyelv.The language that was selected for the script.

64 bites PowerShell-parancsmagok végrehajtása .NET-parancsfájl futtatása tevékenységgelExecute 64-bit PowerShell cmdlets with Run .NET Script activity

A 64 bites Windows PowerShellt a Orchestrator Run.net parancsfájl -tevékenységben futtathatja.You can run 64-bit Windows PowerShell in Orchestrator Run.Net Script activity. Ehhez a következő lépések szükségesek:Use the following steps:

  1. Hozzon létre egy .net-parancsfájl futtatása tevékenységet a rendszertevékenységek csoportjából.Create a Run .Net Script activity from the System activities group.

  2. A részletek > típusa mezőben válassza ki a PowerShell nyelvet.In Details > Type, select PowerShell as the language.

  3. A szkriptben zárja be a PowerShell-parancsokat a következő kódban:In Script, enclose your PowerShell commands in the following code:

    Invoke-Command -ScriptBlock {YOUR CODE} -ComputerName localhost
    
    
  4. Kattintson a Finish (Befejezés) gombra.Click Finish.

    .Net-parancsfájl tevékenysége

Megjegyzés

A PowerShell verziójának ellenőrzéséhez használja a következő parancsfájlt a .net-parancsfájl futtatása tevékenységben, és tegye közzé a 64 bites és a PowerShell-verzió változót.To verify the PowerShell version, use the following script in Run .Net Script activity and publish the 64 bit and PowerShell version variable.


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

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

.Net-parancsfájl tevékenységének megtekintése