Een Windows PowerShell-module schrijven

In dit voorbeeld ziet u hoe u een Windows PowerShell-module schrijft die kan worden gebruikt om alle cmdlets en Windows PowerShell-providers in een assembly te registreren.

Met dit type module selecteert u niet welke cmdlets en providers u wilt registreren. Als u een module wilt schrijven waarmee u kunt selecteren wat is geregistreerd, raadpleegt u Een aangepaste Windows PowerShell-module schrijven.

Een Windows PowerShell-module schrijven

1. Voeg het kenmerk RunInstallerAttribute toe.

2. Maak een openbare klasse die is afgeleid van de klasse System.Management.Automation.PSSnapIn.

   In dit voorbeeld is de klassenaam 'GetProcPSSnapIn01'.

3. Voeg een openbare eigenschap toe voor de naam van de module (vereist). Bij het benoemen van modules, gebruik geen van de volgende tekens: #, ., ,, (, ), {, }, [, ], &, -, /, \, $, ;, :, ", ', <, >, |, ?, @, `, *

   In dit voorbeeld is de naam van de module 'GetProcPSSnapIn01'.

4. Voeg een openbare eigenschap toe voor de leverancier van de module (vereist).

   In dit voorbeeld is de leverancier Microsoft.

5. Voeg een openbare eigenschap toe voor de leverancierresource van de module (optioneel).

   In dit voorbeeld is de leverancierresource 'GetProcPSSnapIn01,Microsoft'.

6. Voeg een openbare eigenschap toe voor de beschrijving van de module (vereist).

   In dit voorbeeld is de beschrijving 'Dit is een Windows PowerShell-module waarmee de Get-Proc-cmdlet wordt geregistreerd'.

7. Voeg een openbare eigenschap toe voor de beschrijvingsresource van de module (optioneel).

   In dit voorbeeld is de leverancierresource 'GetProcPSSnapIn01, dit is een Windows PowerShell-module waarmee de Get-Proc cmdlet wordt geregistreerd'.

Voorbeeld

In dit voorbeeld ziet u hoe u een Windows PowerShell-module schrijft die kan worden gebruikt om de Get-Proc cmdlet te registreren in de Windows PowerShell-shell. Houd er rekening mee dat in dit voorbeeld de volledige assembly alleen de module GetProcPSSnapIn01 en de Get-Proc-cmdlet-klasse bevat.

[RunInstaller(true)]
public class GetProcPSSnapIn01 : PSSnapIn
{
  /// <summary>
  /// Create an instance of the GetProcPSSnapIn01 class.
  /// </summary>
  public GetProcPSSnapIn01()
         : base()
  {
  }

  /// <summary>
  /// Specify the name of the PowerShell snap-in.
  /// </summary>
  public override string Name
  {
    get
    {
      return "GetProcPSSnapIn01";
    }
  }

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

  /// <summary>
  /// Specify the localization resource information for the vendor.
  /// Use the format: resourceBaseName,VendorName.
  /// </summary>
  public override string VendorResource
  {
    get
    {
      return "GetProcPSSnapIn01,Microsoft";
    }
  }

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

  /// <summary>
  /// Specify the localization resource information for the description.
  /// Use the format: resourceBaseName,Description.
  /// </summary>
  public override string DescriptionResource
  {
    get
    {
      return "GetProcPSSnapIn01,This is a PowerShell snap-in that includes the Get-Proc cmdlet.";
    }
  }
}

Zie ook

Cmdlets, providers en hosttoepassingen registreren

Windows PowerShell Shell SDK