Vytvoření modulu snap-in Windows PowerShellu

Tento příklad ukazuje, jak Windows PowerShell modulu snap-in, který lze použít k registraci všech rutin a Windows PowerShell zprostředkovatelů v sestavení.

U tohoto typu modulu snap-in nevyberte, které rutiny a zprostředkovatelé chcete zaregistrovat. Pokud chcete napsat modul snap-in, který vám umožní vybrat, co je zaregistrované, podívejte se na Windows PowerShell modulu snap-in vlastního modulu snap-in.

Vytvoření modulu snap-in Windows PowerShellu

1. Přidejte atribut RunInstallerAttribute.

2. Vytvořte veřejnou třídu odvozenou od třídy System.Management.Automation.PSSnapIn.

   V tomto příkladu má třída název GetProcPSSnapIn01.

3. Přidejte veřejnou vlastnost pro název modulu snap-in (povinné). Při pojmenování modulů snap-in nepoužívejte žádný z následujících znaků: # , , , , , , . , ( ) , { } , , , [ , ] & - / \ $ ; a : " ' < > | ? @ ` . *

   V tomto příkladu má modul snap-in název GetProcPSSnapIn01.

4. Přidejte veřejnou vlastnost pro dodavatele modulu snap-in (povinné).

   V tomto příkladu je dodavatel "Microsoft".

5. Přidejte veřejnou vlastnost pro prostředek dodavatele modulu snap-in (volitelné).

   V tomto příkladu je dodavatelem prostředku GetProcPSSnapIn01,Microsoft.

6. Přidejte veřejnou vlastnost pro popis modulu snap-in (povinné).

   V tomto příkladu je popis "Toto je Windows PowerShell modul snap-in, který registruje rutinu get-proc".

7. Přidejte veřejnou vlastnost pro prostředek popisu modulu snap-in (volitelné).

   V tomto příkladu je dodavatelem prostředku GetProcPSSnapIn01, jedná se o modul snap-in Windows PowerShell který zaregistruje rutinu get-proc.

Příklad

Tento příklad ukazuje, jak Windows PowerShell modulu snap-in, který lze použít k registraci rutiny Get-Proc v Windows PowerShell prostředí. Uvědomte si, že v tomto příkladu by úplné sestavení obsahovalo pouze třídu modulu snap-in GetProcPSSnapIn01 a Get-Proc třídu rutiny .

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

Viz také

Registrace rutin, poskytovatelů a hostitelských aplikací

Windows PowerShell Shell SDK