Ukázka Runspace04

Tato ukázka ukazuje, jak pomocí třídy System.Management.Automation.PowerShell spouštět příkazy a jak zachytit ukončující chyby vyvolané při spuštění příkazů. Spustí se dva příkazy a poslední příkaz předá argument parametru, který není platný. V důsledku toho se nevrátí žádné objekty a vyvolá se ukončující chyba.

Požadavky

Tato ukázka vyžaduje Prostředí Windows PowerShell 2.0.

Demonstruje

Tato ukázka ukazuje následující:

• Vytvoření objektu System.Management.Automation.PowerShell.

• Přidání příkazů do kanálu objektu System.Management.Automation.PowerShell.

• Přidání argumentů parametrů do kanálu

• Synchronní vyvolání příkazů

• Použití System.Management.Automation.PSObject objekty k extrakci a zobrazení vlastností z objektů vrácených příkazy.

• Načítání a zobrazování chybových záznamů, které byly generovány během spouštění příkazů.

• Zachytávání a zobrazování ukončovacích výjimek vyvolaných příkazy

Příklad

Tato ukázka spouští příkazy synchronně ve výchozím prostředí Runspace poskytovaném prostředím Windows PowerShell. Poslední příkaz vyvolá ukončující chybu, protože argument parametru, který není platný, je předán příkazu. Ukončovací chyba se zachytí a zobrazí.

namespace Microsoft.Samples.PowerShell.Runspaces
{
  using System;
  using System.Management.Automation;
  using System.Management.Automation.Runspaces;
  using PowerShell = System.Management.Automation.PowerShell;

  /// <summary>
  /// This class contains the Main entry point for this host application.
  /// </summary>
  internal class Runspace04
  {
    /// <summary>
    /// This sample shows how to use a PowerShell object to run commands.
    /// The commands generate a terminating exception that the caller
    /// should catch and process.
    /// </summary>
    /// <param name="args">The parameter is not used.</param>
    /// <remarks>
    /// This sample demonstrates the following:
    /// 1. Creating a PowerShell object to run commands.
    /// 2. Adding commands to the pipeline of  the PowerShell object.
    /// 3. Passing input objects to the commands from the calling program.
    /// 4. Using PSObject objects to extract and display properties from the
    ///    objects returned by the commands.
    /// 5. Retrieving and displaying error records that were generated
    ///    while running the commands.
    /// 6. Catching and displaying terminating exceptions generated
    ///    while running the commands.
    /// </remarks>
    private static void Main(string[] args)
    {
      // Create a PowerShell object.
      using (PowerShell powershell = PowerShell.Create())
      {
        // Add the commands to the PowerShell object.
        powershell.AddCommand("Get-ChildItem").AddCommand("Select-String").AddArgument("*");

        // Run the commands synchronously. Because of the bad regular expression,
        // no objects will be returned. Instead, an exception will be thrown.
        try
        {
          foreach (PSObject result in powershell.Invoke())
          {
            Console.WriteLine("'{0}'", result.ToString());
          }

          // Process any error records that were generated while running the commands.
          Console.WriteLine("\nThe following non-terminating errors occurred:\n");
          PSDataCollection<ErrorRecord> errors = powershell.Streams.Error;
          if (errors != null && errors.Count > 0)
          {
            foreach (ErrorRecord err in errors)
            {
              System.Console.WriteLine("    error: {0}", err.ToString());
            }
          }
        }
        catch (RuntimeException runtimeException)
        {
          // Trap any exception generated by the commands. These exceptions
          // will all be derived from the RuntimeException exception.
          System.Console.WriteLine(
                        "Runtime exception: {0}: {1}\n{2}",
                        runtimeException.ErrorRecord.InvocationInfo.InvocationName,
                        runtimeException.Message,
                        runtimeException.ErrorRecord.InvocationInfo.PositionMessage);
        }
      }

      System.Console.WriteLine("\nHit any key to exit...");
      System.Console.ReadKey();
    }
  }
}

Viz také

psaní hostitelské aplikace Windows PowerShellu