Voorbeeld GetProcessSample04

In dit voorbeeld ziet u hoe u een cmdlet implementeert die de processen op de lokale computer op haalt. Er wordt een niet-beëindigingsfout gegenereerd als er een fout optreedt tijdens het ophalen van een proces. Deze cmdlet is een vereenvoudigde versie van de Get-Process cmdlet die wordt geleverd door Windows PowerShell 2.0.

Het voorbeeld bouwen met behulp van Visual Studio.

1. Als de Windows PowerShell 2.0 SDK is geïnstalleerd, gaat u naar de map GetProcessSample04. De standaardlocatie is C:\Program Files (x86)\Microsoft SDK's\Windows\v7.0\Samples\sysmgmt\WindowsPowerShell\csharp\GetProcessSample04.

2. Dubbelklik op het pictogram voor het oplossingsbestand (.sln). Hiermee opent u het voorbeeldproject in Visual Studio.

3. Selecteer in het menu Bouwen de optie Oplossing bouwen.

   De bibliotheek voor het voorbeeld wordt gebouwd in de standaardmappen \bin of \bin\debug.

Het voorbeeld uitvoeren

1. Maak de volgende modulemap:

   [user]/documents/windowspowershell/modules/GetProcessSample04

2. Kopieer de voorbeeldassemblage naar de modulemap.

3. Start Windows PowerShell.

4. Voer de volgende opdracht uit om de assembly in de volgende Windows PowerShell:

   Import-module getprossessample04

5. Voer de volgende opdracht uit om de cmdlet uit te voeren:

   get-proc

Vereisten

Voor dit voorbeeld is Windows PowerShell 2.0 vereist.

Demonstreert

In dit voorbeeld wordt het volgende gedemonstreerd.

• Een cmdlet-klasse declareren met behulp van het kenmerk Cmdlet.

• Declareren van een cmdlet parameter met behulp van de Parameter kenmerk.

• De positie van de parameter opgeven.

• Opgeven dat de parameter invoer van de pijplijn gebruikt. De invoer kan worden genomen van een object of een waarde van een eigenschap van een object waarvan de eigenschapsnaam hetzelfde is als de parameternaam.

• Het declareren van een validatiekenmerk voor de parameterinvoer.

• Een niet-beëindigingsfout in de weg zitten en een foutbericht naar de foutstroom schrijven.

Voorbeeld

In dit voorbeeld ziet u hoe u een cmdlet maakt die niet-beëindigingsfouten verwerkt en foutberichten naar de foutstroom schrijft.

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 nonterminating 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
}

Zie ook

Een Windows PowerShell-cmdlet schrijven