Menulis Snap-in Windows PowerShell

Contoh ini menunjukkan cara menulis snap-in Windows PowerShell yang dapat digunakan untuk mendaftarkan semua cmdlet dan penyedia Windows PowerShell dalam rakitan.

Dengan jenis snap-in ini, Anda tidak memilih cmdlet dan penyedia mana yang ingin Anda daftarkan. Untuk menulis snap-in yang memungkinkan Anda memilih apa yang terdaftar, lihat Menulis Snap-in PowerShell Windows Kustom.

Menulis Snap-in Windows PowerShell

1. Tambahkan atribut RunInstallerAttribute.

2. Buat kelas publik yang berasal dari kelas System.Management.Automation.PSSnapIn.

   Dalam contoh ini, nama kelas adalah "GetProcPSSnapIn01".

3. Tambahkan properti publik untuk nama snap-in (diperlukan). Saat penamaan snap-in, jangan gunakan salah satu karakter berikut: #, ., ,, (, ), {, }, [, ], &, -, /, \, $, ;, :, ", ', <, >, |, ?, @, `, *

   Dalam contoh ini, nama snap-in adalah "GetProcPSSnapIn01".

4. Tambahkan properti publik untuk vendor snap-in (diperlukan).

   Dalam contoh ini, vendor adalah "Microsoft".

5. Tambahkan properti publik untuk sumber daya vendor snap-in (opsional).

   Dalam contoh ini, sumber daya vendor adalah "GetProcPSSnapIn01,Microsoft".

6. Tambahkan properti publik untuk deskripsi snap-in (diperlukan).

   Dalam contoh ini, deskripsinya adalah "Ini adalah snap-in Windows PowerShell yang mendaftarkan cmdlet Get-Proc".

7. Tambahkan properti publik untuk sumber daya deskripsi snap-in (opsional).

   Dalam contoh ini, sumber daya vendor adalah "GetProcPSSnapIn01,Ini adalah snap-in Windows PowerShell yang mendaftarkan cmdlet Get-Proc".

Contoh

Contoh ini menunjukkan cara menulis snap-in Windows PowerShell yang dapat digunakan untuk mendaftarkan cmdlet Get-Proc di shell Windows PowerShell. Ketahuilah bahwa dalam contoh ini, rakitan lengkap hanya akan berisi kelas snap-in GetProcPSSnapIn01 dan kelas cmdlet Get-Proc.

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

Lihat Juga

Cara Mendaftarkan Cmdlet, Penyedia, dan Aplikasi Host

Windows PowerShell Shell SDK