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

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

Ilyen típusú beépülő modul esetén nem választhatja ki, hogy mely parancsmagokat és szolgáltatókat szeretné regisztrálni. Ha olyan beépülő modult szeretne írni, amely lehetővé teszi a regisztrált adatok kiválasztását, olvassa el Egyéni Windows PowerShell beépülő modulírása című témakört.

Windows PowerShell 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ő). Beépülő modulok elnevezésekor ne használja a következő karakterek egyikét sem: #, ., ,, (, ), {, }, [, ], &, -, /, \, $, ;, :, ", ', <, >, |, ?, @, `, *

   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 szállító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ásához (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ásához (nem kötelező).

   Ebben a példában a szállítói erőforrás a következő: "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 windowsos PowerShell beépülő modult, amellyel regisztrálhatja a Get-Proc parancsmagot a Windows PowerShell-rendszerhéjban. Vegye figyelembe, hogy ebben a példában a teljes szerelvény csak a GetProcPSSnapIn01 beépülő modult és a Get-Proc parancsmagosztályt tartalmazza.

[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 gazdagépalkalmazások regisztrálása

Windows PowerShell Shell SDK