Ukázka GetProcessSample02

Tato ukázka ukazuje, jak napsat rutinu, která načítá procesy v místním počítači. Poskytuje Name parametr, který lze použít k určení procesů, které se mají načíst. Tato rutina je zjednodušená verze rutiny Get-Process poskytované prostředím Windows PowerShell 2.0.

Postup sestavení ukázky pomocí sady Visual Studio

1. S nainstalovanou sadou Windows PowerShell 2.0 SDK přejděte do složky GetProcessSample02. Výchozí umístění je C:\Program Files (x86)\Microsoft SDKs\Windows\v7.0\Samples\sysmgmt\WindowsPowerShell\csharp\GetProcessSample02.

2. Poklikejte na ikonu souboru řešení (.sln). Tím se otevře ukázkový projekt v sadě Visual Studio.

3. V nabídce Sestavení vyberte Sestavit řešení a sestavte knihovnu ukázky ve výchozích \bin nebo \bin\debug složkách.

Spuštění ukázky

1. Vytvořte následující složku modulu:

   [user]\Documents\WindowsPowerShell\Modules\GetProcessSample02

2. Zkopírujte ukázkové sestavení do složky modulu.

3. Spusťte Windows PowerShell.

4. Spuštěním následujícího příkazu načtěte sestavení do Prostředí Windows PowerShell:

   Import-Module getprossessample02

5. Spuštěním následujícího příkazu spusťte rutinu:

   Get-Proc

Požadavky

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

Demonstruje

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

• Deklarování třídy rutiny pomocí atributu Rutina.

• Deklarování parametru rutiny pomocí atributu Parameter

• Určuje pozici parametru.

• Deklarování ověřovacího atributu pro vstup parametru

Příklad

Tato ukázka ukazuje implementaci rutiny Get-Proc, která obsahuje parametr Name.

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 list of process names on which
    /// the Get-Proc cmdlet will work.
    /// </summary>
    [Parameter(Position = 0)]
    [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 process objects 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 cmdlet, get and write
        // the associated processes.
        foreach (string name in this.processNames)
        {
          WriteObject(Process.GetProcessesByName(name), true);
        }
      } // End if (processNames...).
    } // End ProcessRecord.
    #endregion Cmdlet Overrides
  } // End GetProcCommand class.
  #endregion GetProcCommand
}

Viz také

• psaní rutiny Prostředí Windows PowerShell