Skriva en cmdlet
Den här artikeln visar hur du skriver en cmdlet. Send-Greeting
Cmdleten tar ett enda användarnamn som indata och skriver sedan en hälsning till användaren. Även om cmdleten inte fungerar så mycket visar det här exemplet de viktigaste avsnitten i en cmdlet.
Steg för att skriva en cmdlet
Om du vill deklarera klassen som en cmdlet använder du attributet Cmdlet. Attributet Cmdlet anger verbet och substantivet för cmdlet-namnet.
Mer information om attributet Cmdlet finns i CmdletAttribute-deklarationen.
Ange namnet på klassen.
Ange att cmdleten härleds från någon av följande klasser:
Om du vill definiera parametrarna för cmdleten använder du attributet Parameter. I det här fallet anges bara en obligatorisk parameter.
Mer information om attributet Parameter finns i ParameterAttribute-deklaration.
Åsidosätt bearbetningsmetoden för indata som bearbetar indata. I det här fallet åsidosätts metoden System.Management.Automation.Cmdlet.ProcessRecord.
Skriv hälsningen med hjälp av metoden System.Management.Automation.Cmdlet.WriteObject. Hälsningen visas i följande format:
Hello <UserName>!
Exempel
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 + "!");
}
}
}
Se även
System.Management.Automation.Cmdlet
System.Management.Automation.PSCmdlet
System.Management.Automation.Cmdlet.ProcessRecord
System.Management.Automation.Cmdlet.WriteObject
Deklaration av CmdletAttribute
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för