Skriva en Windows PowerShell-snapin-modul

Artikel
2025-03-25

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

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

Skriva en Windows PowerShell-snapin-modul

Lägg till attributet RunInstallerAttribute.
Skapa en offentlig klass som härleds från klassen System.Management.Automation.PSSnapIn.

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

I det här exemplet är namnet på snapin-modulen "GetProcPSSnapIn01".
Lägg till en offentlig egenskap för leverantören av snapin-modulen (krävs).

I det här exemplet är leverantören "Microsoft".
Lägg till en offentlig egenskap för leverantörsresursen för snapin-modulen (valfritt).

I det här exemplet är leverantörsresursen "GetProcPSSnapIn01,Microsoft".
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 en Windows PowerShell-snapin-modul som registrerar Get-Proc cmdlet".
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 snap-in that registers the Get-Proc cmdlet".

Exempel

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

[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 cmdletar, leverantörer och värdprogram

Windows PowerShell Shell SDK

Dela via

Skriva en Windows PowerShell-snapin-modul