Jak napsat rutinu

  • Článek

Tento článek popisuje, jak napsat rutinu. Rutina jako vstup vezme jedno uživatelské jméno a potom uživateli Send-Greeting zapíše pozdrav. I když rutina příliš neprovede, tento příklad ukazuje hlavní části rutiny.

Postup zápisu rutiny

  1. Chcete-li deklarovat třídu jako rutinu, použijte atribut Cmdlet. Atribut Cmdlet určuje sloveso a podstatné jméno pro název rutiny.

    Další informace o atributu rutiny najdete v tématu Deklarace CmdletAttribute.

  2. Zadejte název třídy.

  3. Určete, že rutina je odvozena z jedné z následujících tříd:

  4. K definování parametrů pro rutinu použijte atribut Parameter. V tomto případě je zadán pouze jeden povinný parametr.

    Další informace o atributu Parameter najdete v tématu Deklarace ParameterAttribute.

  5. Přepište metodu zpracování vstupu, která zpracovává vstup. V tomto případě se přepíše metoda System.Management.Automation.Cmdlet.ProcessRecord.

  6. K napsání pozdravu použijte metodu System.Management.Automation.Cmdlet.WriteObject. Pozdrav se zobrazí v následujícím formátu:

    Hello <UserName>!

Příklad

using System.Management.Automation;  // Windows PowerShell assembly.

namespace SendGreeting
{
  // Declare the class as a cmdlet and specify the
  // appropriate verb and noun for the cmdlet name.
  [Cmdlet(VerbsCommunications.Send, "Greeting")]
  public class SendGreetingCommand : Cmdlet
  {
    // Declare the parameters for the cmdlet.
    [Parameter(Mandatory=true)]
    public string Name
    {
      get { return name; }
      set { name = value; }
    }
    private string name;

    // Override the ProcessRecord method to process
    // the supplied user name and write out a
    // greeting to the user by calling the WriteObject
    // method.
    protected override void ProcessRecord()
    {
      WriteObject("Hello " + name + "!");
    }
  }
}

Viz také

System.Management.Automation.Cmdlet

System.Management.Automation.PSCmdlet

System.Management.Automation.Cmdlet.ProcessRecord

System.Management.Automation.Cmdlet.WriteObject

CmdletAttribute – deklarace

Deklarace ParameterAttribute

Vytvoření rutiny Windows PowerShellu