Importing and Invoking a Windows PowerShell Workflow (Importar e Invocar um Fluxo de Trabalho do Windows PowerShell)

Windows PowerShell 3, permite-lhe importar e invocar um fluxo de trabalho que é embalado como um módulo Windows PowerShell. Para obter informações sobre Windows PowerShell módulos, consulte escrever um Módulo Windows PowerShell.

A classe System.Management.Automation.Psjobproxyé utilizada como representante do lado do cliente para objetos de fluxo de trabalho no servidor. O procedimento a seguir explica como utilizar um objeto System.Management.Automation.Psjobproxypara invocar um fluxo de trabalho.

Criar um objeto PSJobProxy para executar comandos de fluxo de trabalho num servidor remoto.

1. Criar um sistema.Management.Automation.Runspaces.Wsmanconnectioninfoobjeto para criar uma ligação a um espaço de funcionação remoto.

2. Defina o objetivo System.Management.Automation.Runspaces.Wsmanconnectioninfo.Shelluri* do System.Management.Automation.Runspaces.Wsmanconnectioninfopara Microsoft.PowerShell.Workflow especificar um ponto final Windows PowerShell.

3. Crie um espaço de funcionamento que utilize a ligação criada completando os passos anteriores.

4. Criar um sistema.Management.Automation.Powershelle definir a sua propriedade System.Management.Automation.Powershell.Runspace* para o espaço de execução criado no passo anterior.

5. Importe o módulo de fluxo de trabalho e os seus comandos para o System.Management.Automation.Powershell.

6. Crie um objeto System.Management.Automation.Psjobproxy e use-o para executar comandos de fluxo de trabalho no servidor remoto.

Exemplo

O seguinte exemplo de código demonstra como invocar um fluxo de trabalho utilizando Windows PowerShell.

Este exemplo requer Windows PowerShell 3.

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

namespace WorkflowHostTest
{

class Program
    {
        static void Main(string[] args)
        {
            if (args.Length == 0)
            {
                Console.WriteLine("Specify path to Workflow module");
                return;
            }

            string moduleFile = args[0];

            Console.Write("Creating Remote runspace connection...");
            WSManConnectionInfo connectionInfo = new WSManConnectionInfo();

            //Set the shellURI to workflow endpoint Microsoft.PowerShell.Workflow
            connectionInfo.ShellUri = "Microsoft.PowerShell.Workflow";

            //Create and open a runspace.
            Runspace runspace = RunspaceFactory.CreateRunspace(connectionInfo);
            runspace.Open();
            Console.WriteLine("done");

            PowerShell powershell = PowerShell.Create();
            powershell.Runspace = runspace;
            Console.Write("Setting $VerbosePreference=\"Continue\"...");
            powershell.AddScript("$VerbosePreference=\"Continue\"");
            powershell.Invoke();
            Console.WriteLine("done");

            Console.Write("Importing Workflow module...");
            powershell.Commands.Clear();

            //Import the module in to the PowerShell runspace. A XAML file could also be imported directly by using Import-Module.
            powershell.AddCommand("Import-Module").AddArgument(moduleFile);
            powershell.Invoke();
            Console.WriteLine("done");

            Console.Write("Creating job proxy...");
            powershell.Commands.Clear();
            powershell.AddCommand("Get-Proc").AddArgument("*");
            PSJobProxy job = powershell.AsJobProxy();
            Console.WriteLine("done");

                Console.WriteLine();
                Console.WriteLine("Using job proxy and performing operations...");
                Console.WriteLine("State of Job :" + job.JobStateInfo.State.ToString());
                Console.WriteLine("Starting job...");
                job.StartJob();
                Console.WriteLine("State of Job :" + job.JobStateInfo.State.ToString());

                // use blocking enumerator to wait for objects until job finishes
                job.Output.BlockingEnumerator = true;
                foreach (PSObject o in job.Output)
                {
                    Console.WriteLine(o.Properties["ProcessName"].Value.ToString());
                }

                // wait for a random time before attempting to stop job
                Random random = new Random();
                int time = random.Next(1, 10);
                Console.Write("Sleeping for {0} seconds when job is running on another thread...", time);
                System.Threading.Thread.Sleep(time * 1000);
                Console.WriteLine("done");
                Console.WriteLine("Stopping job...");
                job.StopJob();
                Console.WriteLine("State of Job :" + job.JobStateInfo.State.ToString());
                Console.WriteLine();
                job.Finished.WaitOne();
                Console.WriteLine("Output from job");
                Console.WriteLine("---------------");

                foreach (PSObject o in job.Output)
                {
                    Console.WriteLine(o.Properties["ProcessName"].Value.ToString());
                }

                Console.WriteLine();
                Console.WriteLine("Verbose messages from job");
                Console.WriteLine("-------------------------");
                foreach (VerboseRecord v in job.Verbose)
                {
                    Console.WriteLine(v.Message);
                }

            runspace.Close();
        }
    }
}