GetProcessSample03 – minta

Ez a minta bemutatja, hogyan implementálhat egy parancsmagot, amely lekéri a folyamatokat a helyi számítógépen. Egy Name paramétert biztosít, amely képes elfogadni egy objektumot a folyamatból, vagy egy olyan objektum tulajdonságából származó értéket, amelynek tulajdonságneve megegyezik a paraméter nevével. Ez a parancsmag a Windows PowerShell 2.0 által biztosított Get-Process parancsmag egyszerűsített verziója.

A minta létrehozása a Visual Studióval

1. Ha telepítve van a Windows PowerShell 2.0 SDK, lépjen a GetProcessSample03 mappába. Az alapértelmezett hely C:\Program Files (x86)\Microsoft SDKs\Windows\v7.0\Samples\sysmgmt\WindowsPowerShell\csharp\GetProcessSample03.

2. Kattintson duplán a megoldásfájl (.sln) ikonjára. Ez megnyitja a mintaprojektet a Visual Studióban.

3. A Build menüben válassza a Megoldás összeállítása lehetőséget a minta kódtárának az alapértelmezett \bin vagy \bin\debug mappákban való létrehozásához.

A minta futtatása

1. Hozza létre a következő modulmappát:

   [user]\Documents\WindowsPowerShell\Modules\GetProcessSample03

2. Másolja a mintaszerelvényt a modulmappába.

3. Indítsa el a Windows PowerShellt.

4. Futtassa a következő parancsot a szerelvény Windows PowerShellbe való betöltéséhez:

   Import-Module getprossessample03

5. Futtassa a következő parancsot a parancsmag futtatásához:

   Get-Proc

Követelmények

Ehhez a mintához Windows PowerShell 2.0 szükséges.

Megmutatja

Ez a minta a következőket mutatja be.

• Parancsmagosztály deklarálása a Parancsmag attribútummal.

• Parancsmagparaméter deklarálása a Parameter attribútummal.

• A paraméter pozíciójának megadása.

• Annak megadása, hogy a paraméter bemenetet vesz-e a folyamatból. A bemenet egy objektumból vagy egy olyan objektum tulajdonságából származhat, amelynek tulajdonságneve megegyezik a paraméter nevével.

• Érvényesítési attribútum deklarálása a paraméter bemenetéhez.

Példa

Ez a minta a Get-Proc parancsmag implementációját mutatja be, amely egy Name paramétert tartalmaz, amely fogadja a folyamat bemenetét.

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 retrieved by the cmdlet.
    /// </summary>
    private string[] processNames;

    /// <summary>
    /// Gets or sets the names of the
    /// process that the cmdlet will retrieve.
    /// </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 the 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.
        foreach (string name in this.processNames)
        {
          WriteObject(Process.GetProcessesByName(name), true);
        }
      } // End if (processNames ...)
    } // End ProcessRecord.

    #endregion Overrides
  } // End GetProcCommand.
  #endregion GetProcCommand
}

Lásd még:

• Windows PowerShell-parancsmag írása