Esempio di GetProcessSample04

Questo esempio illustra come implementare un cmdlet che recupera i processi nel computer locale. Genera un errore non irreversibile se si verifica un errore durante il recupero di un processo. Questo cmdlet è una versione semplificata del cmdlet Get-Process fornito da Windows PowerShell 2.0.

Come compilare l'esempio con Visual Studio

1. Con Windows PowerShell 2.0 SDK installato, passare alla cartella GetProcessSample04. Il percorso predefinito è C:\Program Files (x86)\Microsoft SDKs\Windows\v7.0\Samples\sysmgmt\WindowsPowerShell\csharp\GetProcessSample04.

2. Fare doppio clic sull'icona per il file della soluzione (.sln). Verrà aperto il progetto di esempio in Visual Studio.

3. Nel menu Compila selezionare Compila soluzione per compilare la libreria per l'esempio nelle cartelle predefinite \bin o \bin\debug.

Come eseguire l'esempio

1. Creare la cartella del modulo seguente:

   [user]\Documents\WindowsPowerShell\Modules\GetProcessSample04

2. Copiare l'assembly di esempio nella cartella del modulo.

3. Avviare Windows PowerShell.

4. Eseguire il comando seguente per caricare l'assembly in Windows PowerShell:

   Import-Module getprossessample04

5. Eseguire il comando seguente per eseguire il cmdlet :

   Get-Proc

Requisiti

Questo esempio richiede Windows PowerShell 2.0.

Dimostra

In questo esempio viene illustrato quanto segue.

• Dichiarazione di una classe cmdlet tramite l'attributo Cmdlet.

• Dichiarazione di un parametro di cmdlet tramite l'attributo Parameter.

• Specifica della posizione del parametro.

• Specificando che il parametro accetta l'input dalla pipeline. L'input può essere ricavato da un oggetto o da un valore di una proprietà di un oggetto il cui nome della proprietà corrisponde al nome del parametro.

• Dichiarazione di un attributo di convalida per l'input del parametro.

• Intercettazione di un errore non irreversibile e scrittura di un messaggio di errore nel flusso di errore.

Esempio

Questo esempio illustra come creare un cmdlet che gestisce gli errori non irreversibili e scrive i messaggi di errore nel flusso di errori.

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
}

Vedere anche

• scrittura di un cmdlet di Windows PowerShell