Windows PowerShelles beépülő modul írása

Ez a példa bemutatja, hogyan írhat egy Windows PowerShell beépülő modult, amely az összes parancsmag és Windows PowerShell regisztrálható egy szerelvényben.

Az ilyen típusú beépülő modulokkal nem választhatja ki, hogy mely parancsmagokat és szolgáltatókat szeretné regisztrálni. Ha olyan beépülő modult kell írnia, amely lehetővé teszi a regisztrált Windows PowerShell kiválasztását, tekintse meg a következőt: Writing a Custom Windows PowerShell Snap-in(Egyéni modul írása).

Windows PowerShelles beépülő modul írása

1. Adja hozzá a RunInstallerAttribute attribútumot.

2. Hozzon létre egy nyilvános osztályt, amely a System.Management.Automation.PSSnapIn osztályból származik.

   Ebben a példában az osztály neve "GetProcPSSnapIn01".

3. Adjon hozzá egy nyilvános tulajdonságot a beépülő modul nevéhez (kötelező). A beépülő modulok elnevezésekor ne használja a következő karakterek egyikét: # , . , ( ) { } [ ] & - / \ $ ; : " ' < > | ? @ `` ```*

   Ebben a példában a beépülő modul neve "GetProcPSSnapIn01".

4. Adjon hozzá egy nyilvános tulajdonságot a beépülő modul gyártójához (kötelező).

   Ebben a példában a szállító a "Microsoft".

5. Adjon hozzá egy nyilvános tulajdonságot a beépülő modul szállítói erőforrása számára (nem kötelező).

   Ebben a példában a szállítói erőforrás a "GetProcPSSnapIn01,Microsoft".

6. Adjon hozzá egy nyilvános tulajdonságot a beépülő modul leírásához (kötelező).

   Ebben a példában a leírás a következő: "Ez egy Windows PowerShell beépülő modul, amely regisztrálja a get-proc parancsmagot".

7. Adjon hozzá egy nyilvános tulajdonságot a beépülő modul leírási erőforrása számára (nem kötelező).

   Ebben a példában a szállítói erőforrás a "GetProcPSSnapIn01,Ez egy Windows PowerShell beépülő modul, amely regisztrálja a get-proc parancsmagot".

Példa

Ez a példa bemutatja, hogyan írhat egy Windows PowerShell beépülő modult, amely a parancsmag Get-Proc a Windows PowerShell rendszerhéjban. Vegye figyelembe, hogy ebben a példában a teljes szerelvény csak a GetProcPSSnapIn01 beépülő modul osztályt és a Get-Proc parancsmagosztályt tartalmazná.

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

Lásd még:

Parancsmagok, szolgáltatók és gazdaalkalmazások regisztrálása

Windows PowerShell Shell SDK