Runspace04 Örneği

Bu örnek, komutları çalıştırmak için System.Management.Automation.Powershell sınıfının nasıl kullanılacağını ve komutları çalıştırırken oluşan sonlandırma hatalarının nasıl yakalanacağını gösterir. İki komut çalıştırılır ve son komuta geçerli olmayan bir parametre bağımsız değişkeni iletilir. Sonuç olarak hiçbir nesne döndürülmez ve bir sonlandırma hatası atılır.

Gereksinimler

Bu örnek Windows PowerShell 2,0 gerektirir.

gösterir

Bu örnek aşağıdakileri göstermektedir.

  • System.Management.Automation.Powershell nesnesi oluşturma.

  • System.Management.Automation.Powershell nesnesinin işlem hattına komutlar ekleme.

  • İşlem hattına parametre bağımsız değişkenleri ekleme.

  • Komutları eşzamanlı olarak çağırmak.

  • Komutların döndürdüğü nesnelerden özellikleri ayıklamak ve görüntülemek için System.Management.Automation.PSObject nesnelerini kullanma.

  • Komutların çalıştırılması sırasında oluşturulan hata kayıtlarının alınması ve görüntülenmesi.

  • Komutlar tarafından oluşturulan sonlandırıcı istisnaların yakalanması ve görüntülenmesi.

Örnek

Bu örnek, komutları Windows PowerShell tarafından sağlanan varsayılan çalışma alanında eşzamanlı olarak çalıştırır. Son komut, geçerli olmayan bir parametre bağımsız değişkeninin komuta iletilmesi nedeniyle bir sonlandırma hatası veriyor. Sonlandırma hatası yakalanır ve görüntülenir.

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();
    }
  }
}

Ayrıca Bakınız

Windows PowerShell Ana Bilgisayar Uygulaması Yazma

İlgili makaleler