Meghívó parancsok hozzáadása

A futtatókörnyezet létrehozása után Windows PowerShell-parancsokat és szkripteket adhat hozzá egy folyamathoz, majd szinkronizálva vagy aszinkron módon hívhatja meg a folyamatot.

Folyamat létrehozása

A System.Management.Automation.PowerShell osztály számos metódust kínál parancsok, paraméterek és szkriptek hozzáadásához a folyamathoz. A folyamatot szinkron módon hívhatja meg a System.Management.Automation.PowerShell.Invoke* metódus túlterhelésének meghívásával, vagy aszinkron módon a System.Management.Automation.PowerShell.BeginInvoke*, majd a System.Management.Automation.PowerShell.EndInvoke* metódus túlterhelésének meghívásával.

AddCommand

1. Hozzon létre egy System.Management.Automation.PowerShell objektumot.

   PowerShell ps = PowerShell.Create();
   

2. Adja hozzá a végrehajtani kívánt parancsot.

   ps.AddCommand("Get-Process");
   

3. Hívja meg a parancsot.

   ps.Invoke();
   

Ha a System.Management.Automation.PowerShell.AddCommand* metódust többször is meghívja, mielőtt meghívja a System.Management.Automation.PowerShell.Invoke* metódust, az első parancs eredménye a másodikra lesz állítva, és így tovább. Ha nem szeretné az előző parancs eredményét egy parancsra csövezni, adja hozzá a System.Management.Automation.PowerShell.AddStatement* meghívásával.

AddParameter

Az előző példa egyetlen parancsot hajt végre paraméterek nélkül. Paramétereket adhat a parancshoz a System.Management.Automation.PSCommand.AddParameter* metódussal. Az alábbi kód például lekéri a gépen futó powershell nevű folyamatok listáját.

PowerShell.Create().AddCommand("Get-Process")
                   .AddParameter("Name", "powershell")
                   .Invoke();

További paraméterek hozzáadásához hívja meg System.Management.Automation.PSCommand.AddParameter* ismételt meghívását.

PowerShell.Create().AddCommand("Get-Command")
                   .AddParameter("Name", "Get-VM")
                   .AddParameter("Module", "Hyper-V")
                   .Invoke();

A paraméternevek és -értékek szótárát is hozzáadhatja a System.Management.Automation.PowerShell.AddParameters* metódus meghívásával.

IDictionary parameters = new Dictionary<String, String>();
parameters.Add("Name", "Get-VM");

parameters.Add("Module", "Hyper-V");
PowerShell.Create().AddCommand("Get-Command")
   .AddParameters(parameters)
      .Invoke()

AddStatement

A kötegelt feldolgozás szimulálásához használja a System.Management.Automation.PowerShell.AddStatement* metódust, amely egy további utasítást ad hozzá a folyamat végéhez A következő kód lekéri a futó folyamatok powershellnevű listáját, majd lekéri a futó szolgáltatások listáját.

PowerShell ps = PowerShell.Create();
ps.AddCommand("Get-Process").AddParameter("Name", "powershell");
ps.AddStatement().AddCommand("Get-Service");
ps.Invoke();

AddScript

Meglévő szkript futtatásához hívja meg a System.Management.Automation.PowerShell.AddScript* metódust. Az alábbi példa egy szkriptet ad hozzá a folyamathoz, és futtatja azt. Ez a példa feltételezi, hogy már létezik egy MyScript.ps1 nevű szkript egy D:\PSScriptsnevű mappában.

PowerShell ps = PowerShell.Create();
ps.AddScript(File.ReadAllText(@"D:\PSScripts\MyScript.ps1")).Invoke();

A System.Management.Automation.PowerShell.AddScript* metódus egy useLocalScopenevű logikai paramétert használ. Ha ez a paraméter trueértékre van állítva, akkor a szkript a helyi hatókörben fut. A következő kód futtatja a szkriptet a helyi hatókörben.

PowerShell ps = PowerShell.Create();
ps.AddScript(File.ReadAllText(@"D:\PSScripts\MyScript.ps1"), true).Invoke();

Folyamat szinkronizálása

Miután elemeket ad hozzá a folyamathoz, meghívja azt. A folyamat szinkron meghívásához meghívja a System.Management.Automation.PowerShell.Invoke* metódus túlterhelését. Az alábbi példa bemutatja, hogyan hívhat meg szinkron módon egy folyamatot.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Management.Automation;

namespace HostPS1e
{
  class HostPS1e
  {
    static void Main(string[] args)
    {
      // Using the PowerShell.Create and AddCommand
      // methods, create a command pipeline.
      PowerShell ps = PowerShell.Create().AddCommand ("Sort-Object");

      // Using the PowerShell.Invoke method, run the command
      // pipeline using the supplied input.
      foreach (PSObject result in ps.Invoke(new int[] { 3, 1, 6, 2, 5, 4 }))
      {
          Console.WriteLine("{0}", result);
      } // End foreach.
    } // End Main.
  } // End HostPS1e.
}

Folyamat aszinkron meghívása

A folyamat aszinkron meghívásához meghívja a System.Management.Automation.PowerShell.BeginInvoke* túlterhelését egy IAsyncResult objektum létrehozásához, majd meghívja a System.Management.Automation.PowerShell.EndInvoke* metódust.

Az alábbi példa bemutatja, hogyan hívhat meg egy folyamatot aszinkron módon.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Management.Automation;

namespace HostPS3
{
  class HostPS3
  {
    static void Main(string[] args)
    {
      // Use the PowerShell.Create and PowerShell.AddCommand
      // methods to create a command pipeline that includes
      // Get-Process cmdlet. Do not include spaces immediately
      // before or after the cmdlet name as that will cause
      // the command to fail.
      PowerShell ps = PowerShell.Create().AddCommand("Get-Process");

      // Create an IAsyncResult object and call the
      // BeginInvoke method to start running the
      // command pipeline asynchronously.
      IAsyncResult asyncpl = ps.BeginInvoke();

      // Using the PowerShell.Invoke method, run the command
      // pipeline using the default runspace.
      foreach (PSObject result in ps.EndInvoke(asyncpl))
      {
        Console.WriteLine("{0,-20}{1}",
                result.Members["ProcessName"].Value,
                result.Members["Id"].Value);
      } // End foreach.
      System.Console.WriteLine("Hit any key to exit.");
      System.Console.ReadKey();
    } // End Main.
  } // End HostPS3.
}

Lásd még:

InitialSessionState létrehozása

Korlátozott futtatótér- létrehozása