Schreiben eines Windows PowerShell-Snap-Ins

Dieses Beispiel zeigt, wie Sie ein Windows PowerShell-Snap-In schreiben, das zum Registrieren aller Cmdlets und Windows PowerShell-Anbieter in einer Assembly verwendet werden kann.

Bei diesem Snap-In-Typ wählen Sie nicht aus, welche Cmdlets und Anbieter Sie registrieren möchten. Informationen zum Schreiben eines Snap-Ins, mit dem Sie auswählen können, was registriert ist, finden Sie unter Schreiben eines benutzerdefinierten Windows PowerShell-Snap-Ins.

Schreiben eines Windows PowerShell-Snap-Ins

1. Fügen Sie das RunInstallerAttribute-Attribut hinzu.

2. Erstellen Sie eine öffentliche Klasse, die von der System.Management.Automation.PSSnapIn Klasse abgeleitet wird.

   In diesem Beispiel lautet der Klassenname "GetProcPSSnapIn01".

3. Fügen Sie eine öffentliche Eigenschaft für den Namen des Snap-Ins hinzu (erforderlich). Beim Benennen von Snap-Ins verwenden Sie keine der folgenden Zeichen: #, ., ,, (, ), {, }, [, ], &, -, /, , \, $, ;, :, ", ', <, >, |, ?, @, `, *

   In diesem Beispiel lautet der Name des Snap-Ins "GetProcPSSnapIn01".

4. Fügen Sie eine öffentliche Eigenschaft für den Anbieter des Snap-Ins hinzu (erforderlich).

   In diesem Beispiel lautet der Anbieter "Microsoft".

5. Fügen Sie eine öffentliche Eigenschaft für die Lieferantenressource des Snap-Ins hinzu (optional).

   In diesem Beispiel lautet die Lieferantenressource "GetProcPSSnapIn01,Microsoft".

6. Fügen Sie eine öffentliche Eigenschaft für die Beschreibung des Snap-Ins hinzu (erforderlich).

   In diesem Beispiel lautet die Beschreibung "Dies ist ein Windows PowerShell-Snap-In, das das cmdlet Get-Proc registriert".

7. Fügen Sie eine öffentliche Eigenschaft für die Beschreibungsressource des Snap-Ins hinzu (optional).

   In diesem Beispiel lautet die Anbieterressource "GetProcPSSnapIn01,Dies ist ein Windows PowerShell-Snap-In, das das cmdlet Get-Proc registriert".

Beispiel

In diesem Beispiel wird gezeigt, wie Sie ein Windows PowerShell-Snap-In schreiben, das zum Registrieren des cmdlets Get-Proc in der Windows PowerShell-Shell verwendet werden kann. Beachten Sie, dass in diesem Beispiel die vollständige Assembly nur die GetProcPSSnapIn01-Snap-In-Klasse und die Get-Proc Cmdlet-Klasse enthalten würde.

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

Siehe auch

Registrieren von Cmdlets, Anbietern und Hostanwendungen

Windows PowerShell Shell SDK-