Esempio di GetProcessSample03

Articolo
09/24/2021

Questo esempio illustra come implementare un cmdlet che recupera i processi nel computer locale. Fornisce un parametro che può accettare un oggetto dalla pipeline o un valore da una proprietà di un oggetto il cui nome di proprietà è lo stesso Name del nome del parametro. Questo cmdlet è una versione semplificata del Get-Process cmdlet fornita da Windows PowerShell 2.0.

Come compilare l'esempio usando Visual Studio.

Con l Windows PowerShell SDK 2.0 installato, passare alla cartella GetProcessSample03. Il percorso predefinito è C:\Programmi (x86)\Microsoft SDK\Windows\v7.0\Samples\sysmgmt\WindowsPowerShell\csharp\GetProcessSample03.
Fare doppio clic sull'icona per il file di soluzione (sln). Verrà aperto il progetto di esempio in Visual Studio.
Scegliere Compila soluzione dal menu Compila.

La libreria per l'esempio verrà compilata nelle cartelle \bin o \bin\debug predefinite.

Per eseguire l'esempio

Creare la cartella del modulo seguente:

[user]/documents/windowspowershell/modules/GetProcessSample03
Copiare l'assembly di esempio nella cartella del modulo.
Avviare Windows PowerShell.
Eseguire il comando seguente per caricare l'assembly in Windows PowerShell:

Import-module getprossessample03
Eseguire il comando seguente per eseguire il cmdlet :

get-proc

Requisiti

Questo esempio richiede Windows PowerShell 2.0.

Dimostra

Questo esempio illustra quanto segue.

Dichiarazione di una classe di cmdlet tramite l'attributo Cmdlet.
Dichiarazione di un parametro del cmdlet tramite l'attributo Parameter.
Specifica della posizione del parametro.
Specifica che il parametro accetta input dalla pipeline. L'input può essere tratto da un oggetto o da un valore di una proprietà di un oggetto il cui nome della proprietà è lo stesso del nome del parametro.
Dichiarazione di un attributo di convalida per l'input del parametro.

Esempio

Questo esempio illustra un'implementazione del cmdlet Get-Proc che include un Name parametro che accetta input dalla pipeline.

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
}

Vedere anche

Scrittura di un cmdlet di Windows PowerShell

Condividi tramite