Skriva en Windows PowerShell-snapin-modul

Det här exemplet visar hur du skriver Windows PowerShell snapin-modulen som kan användas för att registrera alla cmdlets och Windows PowerShell providers i en sammansättning.

Med den här typen av snapin-modulen väljer du inte vilka cmdlets och leverantörer som du vill registrera. Om du vill skriva en snapin-modulen som gör att du kan välja vad som är registrerat kan du läsa Skriva en anpassad Windows PowerShell snapin-modulen.

Skriva en Windows PowerShell-snapin-modul

1. Lägg till attributet RunInstallerAttribute.

2. Skapa en offentlig klass som härleds från klassen System.Management.Automation.PSSnapIn.

   I det här exemplet är klassnamnet "GetProcPSSnapIn01".

3. Lägg till en offentlig egenskap för namnet på snapin-modulen (krävs). Använd inte något av följande tecken när du namnger snapin-modulen: # , , , , , . , , , , , ( , , ) , , , , { , , } [ ] & , - / \ $ ; : " ' < > , | ? @ `` ```*

   I det här exemplet är namnet på snapin-modulen "GetProcPSSnapIn01".

4. Lägg till en offentlig egenskap för leverantören av snapin-modulen (krävs).

   I det här exemplet är leverantören "Microsoft".

5. Lägg till en offentlig egenskap för snapin-modulens leverantörsresurs (valfritt).

   I det här exemplet är leverantörsresursen "GetProcPSSnapIn01,Microsoft".

6. Lägg till en offentlig egenskap för beskrivningen av snapin-modulen (krävs).

   I det här exemplet är beskrivningen "Det här är Windows PowerShell snapin-modulen som registrerar cmdleten get-proc".

7. Lägg till en offentlig egenskap för beskrivningsresursen för snapin-modulen (valfritt).

   I det här exemplet är leverantörsresursen "GetProcPSSnapIn01,This is a Windows PowerShell snapin-in that registers the get-proc cmdlet".

Exempel

Det här exemplet visar hur du skriver Windows PowerShell snapin-modulen som kan användas för att registrera Get-Proc-cmdleten i Windows PowerShell gränssnittet. Tänk på att i det här exemplet skulle den fullständiga sammansättningen endast innehålla snapin-modulen GetProcPSSnapIn01 och Get-Proc cmdlet-klassen.

[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.";
    }
  }
}

Se även

Registrera cmdlets, providers och värdprogram

Windows PowerShell Shell SDK