Esempio di GetProcessSample01

Articolo
09/24/2021

Questo esempio illustra come implementare un cmdlet che recupera i processi nel computer locale. Questo cmdlet è una versione semplificata del cmdlet fornita Get-Process da Windows PowerShell 2.0.

Come compilare l'esempio usando Visual Studio.

Con l Windows PowerShell SDK 2.0 installato, passare alla cartella GetProcessSample01. Il percorso predefinito è C:\Programmi (x86)\Microsoft SDKs\Windows\v7.0\Samples\sysmgmt\WindowsPowerShell\csharp\GetProcessSample01.
Fare doppio clic sull'icona per il file di soluzione (sln). Verrà aperto il progetto di esempio in Microsoft 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

Aprire una finestra del prompt dei comandi.
Passare alla directory contenente il file di .dll di esempio.
Eseguire installutil "GetProcessSample01.dll".
Avviare Windows PowerShell.
Eseguire il comando seguente per aggiungere lo snap-in alla shell.

Add-PSSnapin GetProcPSSnapIn01

Immettere il comando seguente per eseguire il cmdlet. get-proc

get-proc

Si tratta di un output di esempio derivato dalla procedura seguente.

Id              Name            State      HasMoreData     Location             Command
--              ----            -----      -----------     --------             -------
1               26932870-d3b... NotStarted False                                 Write-Host "A f...

Set-Content $env:temp\test.txt "This is a test file"

A file was created in the TEMP directory

Requisiti

Questo esempio richiede Windows PowerShell 1.0 o versione successiva.

Dimostra

Questo esempio illustra quanto segue.

Creazione di un cmdlet di esempio di base.
Definizione di una classe di cmdlet tramite l'attributo Cmdlet.
Creazione di uno snap-in che funziona con Windows PowerShell 1.0 e Windows PowerShell 2.0. Gli esempi successivi usano moduli anziché snap-in, quindi richiedono Windows PowerShell 2.0.

Esempio

Questo esempio illustra come creare un cmdlet semplice e il relativo snap-in.

using System;
using System.Diagnostics;
using System.Management.Automation;             //Windows PowerShell namespace
using System.ComponentModel;

namespace Microsoft.Samples.PowerShell.Commands
{

   #region GetProcCommand

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

      /// <summary>
      /// The ProcessRecord method calls the Process.GetProcesses
      /// method to retrieve the processes of the local computer.
      /// Then, the WriteObject method writes the associated processes
      /// to the pipeline.
      /// </summary>
      protected override void ProcessRecord()
      {
         // Retrieve the current processes.
         Process[] processes = Process.GetProcesses();

         // Write the processes to the pipeline to make them available
         // to the next cmdlet. The second argument (true) tells Windows
         // PowerShell to enumerate the array and to send one process
         // object at a time to the pipeline.
         WriteObject(processes, true);
      }

      #endregion Overrides

   } //GetProcCommand

   #endregion GetProcCommand

   #region PowerShell snap-in

   /// <summary>
   /// Create this sample as an PowerShell snap-in
   /// </summary>
   [RunInstaller(true)]
   public class GetProcPSSnapIn01 : PSSnapIn
   {
       /// <summary>
       /// Create an instance of the GetProcPSSnapIn01
       /// </summary>
       public GetProcPSSnapIn01()
           : base()
       {
       }

       /// <summary>
       /// Get a name for this PowerShell snap-in. This name will be used in registering
       /// this PowerShell snap-in.
       /// </summary>
       public override string Name
       {
           get
           {
               return "GetProcPSSnapIn01";
           }
       }

       /// <summary>
       /// Vendor information for this PowerShell snap-in.
       /// </summary>
       public override string Vendor
       {
           get
           {
               return "Microsoft";
           }
       }

       /// <summary>
       /// Gets resource information for vendor. This is a string of format:
       /// resourceBaseName,resourceName.
       /// </summary>
       public override string VendorResource
       {
           get
           {
               return "GetProcPSSnapIn01,Microsoft";
           }
       }

       /// <summary>
       /// Description of this PowerShell snap-in.
       /// </summary>
       public override string Description
       {
           get
           {
               return "This is a PowerShell snap-in that includes the get-proc cmdlet.";
           }
       }
   }

   #endregion PowerShell snap-in
}

Vedere anche

Scrittura di un cmdlet di Windows PowerShell

Condividi tramite