Freigeben über

GetProcessSample04-Beispiel

In diesem Beispiel wird gezeigt, wie Sie ein Cmdlet implementieren, das die Prozesse auf dem lokalen Computer abruft. Er generiert einen nicht beendeten Fehler, wenn beim Abrufen eines Prozesses ein Fehler auftritt. Dieses Cmdlet ist eine vereinfachte Version des von Windows PowerShell 2.0 bereitgestellten Get-Process-Cmdlets.

Erstellen des Beispiels mit Visual Studio

  1. Navigieren Sie mit dem installierten Windows PowerShell 2.0 SDK zum Ordner "GetProcessSample04". Der Standardspeicherort ist C:\Program Files (x86)\Microsoft SDKs\Windows\v7.0\Samples\sysmgmt\WindowsPowerShell\csharp\GetProcessSample04.

  2. Doppelklicken Sie auf das Symbol für die Lösungsdatei (.sln). Dadurch wird das Beispielprojekt in Visual Studio geöffnet.

  3. Wählen Sie im Menü ErstellenProjektmappe erstellen aus, um die Bibliothek für das Beispiel in den Standardordnern \bin oder \bin\debug zu erstellen.

Wie das Beispiel ausgeführt wird

  1. Erstellen Sie den folgenden Modulordner:

    [user]\Documents\WindowsPowerShell\Modules\GetProcessSample04

  2. Kopieren Sie die Beispielassembly in den Modulordner.

  3. Starten Sie Windows PowerShell.

  4. Führen Sie den folgenden Befehl aus, um die Assembly in Windows PowerShell zu laden:

    Import-Module getprossessample04

  5. Führen Sie den folgenden Befehl aus, um das Cmdlet auszuführen:

    Get-Proc

Anforderungen

In diesem Beispiel ist Windows PowerShell 2.0 erforderlich.

Veranschaulichung

In diesem Beispiel wird Folgendes veranschaulicht.

  • Deklarieren einer Cmdlet-Klasse mithilfe des Cmdlet-Attributs.

  • Deklarieren eines Cmdlet-Parameters mithilfe des Parameter-Attributs.

  • Angeben der Position des Parameters.

  • Gibt an, dass der Parameter Eingaben aus der Pipeline übernimmt. Die Eingabe kann aus einem Objekt oder einem Wert aus einer Eigenschaft eines Objekts entnommen werden, dessen Eigenschaftsname mit dem Parameternamen identisch ist.

  • Deklarieren eines Überprüfungsattributs für die Parametereingabe.

  • Abfangen eines nicht beendeten Fehlers und Schreiben einer Fehlermeldung in den Fehlerdatenstrom.

Beispiel

In diesem Beispiel wird gezeigt, wie Sie ein Cmdlet erstellen, das nicht beendete Fehler behandelt und Fehlermeldungen in den Fehlerdatenstrom schreibt.

namespace Microsoft.Samples.PowerShell.Commands
{
    using System;
    using System.Diagnostics;
    using System.Management.Automation;      // Windows PowerShell namespace.
   #region GetProcCommand

   /// <summary>
   /// This class implements the Get-Proc cmdlet.
   /// </summary>
   [Cmdlet(VerbsCommon.Get, "Proc")]
   public class GetProcCommand : Cmdlet
   {
      #region Parameters

       /// <summary>
       /// The names of the processes to act on.
       /// </summary>
       private string[] processNames;

      /// <summary>
      /// Gets or sets the list of process names on
      /// which the Get-Proc cmdlet will work.
      /// </summary>
      [Parameter(
         Position = 0,
         ValueFromPipeline = true,
         ValueFromPipelineByPropertyName = true)]
      [ValidateNotNullOrEmpty]
      public string[] Name
      {
         get { return this.processNames; }
         set { this.processNames = value; }
      }

      #endregion Parameters

      #region Cmdlet Overrides

      /// <summary>
      /// The ProcessRecord method calls the Process.GetProcesses
      /// method to retrieve the processes specified by the Name
      /// parameter. Then, the WriteObject method writes the
      /// associated processes to the pipeline.
      /// </summary>
      protected override void ProcessRecord()
      {
          // If no process names are passed to cmdlet, get all
          // processes.
          if (this.processNames == null)
          {
              WriteObject(Process.GetProcesses(), true);
          }
          else
          {
              // If process names are passed to the cmdlet, get and write
              // the associated processes.
              // If a non-terminating error occurs while retrieving processes,
              // call the WriteError method to send an error record to the
              // error stream.
              foreach (string name in this.processNames)
              {
                  Process[] processes;

                  try
                  {
                      processes = Process.GetProcessesByName(name);
                  }
                  catch (InvalidOperationException ex)
                  {
                      WriteError(new ErrorRecord(
                         ex,
                         "UnableToAccessProcessByName",
                         ErrorCategory.InvalidOperation,
                         name));
                      continue;
                  }

                  WriteObject(processes, true);
              } // foreach (string name...
          } // else
      } // ProcessRecord

      #endregion Overrides
    } // End GetProcCommand class.

   #endregion GetProcCommand
}

Siehe auch

  • Last updated on