Přidání a vyvolávání příkazů

Článek
03/25/2025

Po vytvoření runspace můžete do kanálu přidat příkazy a skripty Prostředí Windows PowerShell a pak kanál synchronně nebo asynchronně vyvolat.

Vytvoření kanálu

Třída System.Management.Automation.PowerShell poskytuje několik metod pro přidání příkazů, parametrů a skriptů do kanálu. Kanál můžete vyvolat synchronně voláním přetížení System.Management.Automation.PowerShell.Invoke* metoda, nebo asynchronně voláním přetížení System.Management.Automation.PowerShell.BeginInvoke* a pak System.Management.Automation.PowerShell.EndInvoke* metody.

AddCommand

Vytvořte objekt System.Management.Automation.PowerShell.
```
PowerShell ps = PowerShell.Create();
```
Přidejte příkaz, který chcete spustit.
```
ps.AddCommand("Get-Process");
```
Vyvolání příkazu
```
ps.Invoke();
```

Pokud voláte metodu System.Management.Automation.PowerShell.AddCommand* více než jednou předtím, než zavoláte metodu System.Management.Automation.PowerShell.Invoke*, výsledek prvního příkazu se předá na druhý atd. Pokud nechcete převést výsledek předchozího příkazu na příkaz, přidejte ho voláním System.Management.Automation.PowerShell.AddStatement*.

AddParameter

Předchozí příklad spustí jeden příkaz bez parametrů. K příkazu můžete přidat parametry pomocí metody System.Management.Automation.PSCommand.AddParameter* například následující kód získá seznam všech procesů, které jsou pojmenované powershell spuštěné na počítači.

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

Další parametry můžete přidat voláním System.Management.Automation.PSCommand.AddParameter* opakovaně.

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

Slovník názvů a hodnot parametrů můžete také přidat voláním metody System.Management.Automation.PowerShell.AddParameters*.

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

Dávkování můžete simulovat pomocí metody System.Management.Automation.PowerShell.AddStatement*, která na konec kanálu přidá další příkaz. Následující kód získá seznam spuštěných procesů s názvem powershella pak získá seznam spuštěných služeb.

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

AddScript

Existující skript můžete spustit voláním metody System.Management.Automation.PowerShell.AddScript*. Následující příklad přidá do kanálu skript a spustí ho. Tento příklad předpokládá, že již existuje skript s názvem MyScript.ps1 ve složce s názvem D:\PSScripts.

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

K dispozici je také verze metody System.Management.Automation.PowerShell.AddScript*, která přebírá logický parametr s názvem useLocalScope. Pokud je tento parametr nastavený na true, skript se spustí v místním oboru. Následující kód spustí skript v místním oboru.

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

Synchronní vyvolání kanálu

Po přidání prvků do kanálu ho vyvoláte. Pokud chcete kanál vyvolat synchronně, zavoláte přetížení metody System.Management.Automation.PowerShell.Invoke*. Následující příklad ukazuje, jak synchronně vyvolat kanál.

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.
}

Asynchronní vyvolání kanálu

Kanál vyvoláte asynchronně voláním přetížení System.Management.Automation.PowerShell.BeginInvoke* k vytvoření IAsyncResult objektu a voláním metody System.Management.Automation.PowerShell.EndInvoke*.

Následující příklad ukazuje, jak asynchronně vyvolat kanál.

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.
}

Viz také

vytvoření InitialSessionState

Vytvoření omezeného prostředí runspace

Sdílet prostřednictvím