Parancsmag osztálydeklarációja

A Microsoft .NET-keretrendszer osztály parancsmagként van deklarálva a Parancsmag attribútumnak az osztály metaadataiként való megadásával. (A Parancsmag attribútum az egyetlen kötelező attribútum az összes parancsmaghoz). A Parancsmag attribútum megadásakor meg kell adnia azt az ige-főnév párt, amely azonosítja a parancsmagot a felhasználó számára. A parancsmag által támogatott Windows PowerShell is le kell írnia. A Parancsmag attribútum megadásához használt deklaráció szintaxisával kapcsolatos további információkért lásd: Parancsmag-attribútumdeklaráció.

Megjegyzés

A Parancsmag attribútumot a System.Management.Automation.CmdletAttribute osztály határozza meg. Ennek az osztálynak a tulajdonságai megfelelnek az attribútum deklarálásakor használt deklarációs paramétereknek.

Főnevek

A parancsmag főnéve határozza meg azokat az erőforrásokat, amelyeken a parancsmag működik. A főnév megkülönbözteti a parancsmagokat a többi parancsmagtól.

A parancsmagnevekben a főneveknek konkrétnak kell lennie, és általános főnevek, például a kiszolgáló esetében a legjobb, ha egy rövid előtagot ad hozzá, amely megkülönbözteti az erőforrást a többi hasonló erőforrástól. Például a parancsmag neve, amely tartalmaz egy főnevet egy előtaggal, Get-SQLServer a következő: . Egy adott főnév és egy általánosabb parancs együttes használatával a felhasználó gyorsan megkeresheti a parancsmagot a műveletével, majd az erőforrás alapján azonosíthatja a parancsmagot, és elkerülheti a parancsmagok felesleges megkettőzését.

A parancsmagok neveiben nem használható speciális karakterek listájáért lásd: Required Development Guidelines (Szükséges fejlesztési irányelvek).

Parancsok

Amikor megad egy ige, a fejlesztési irányelvek megkövetelik, hogy a felhasználó által megadott előre meghatározott műveletek Windows PowerShell. Ezen előre meghatározott műveletek egyikével biztosíthatja a konzisztenciát az Ön által írt parancsmagok és a Microsoft és mások által írt parancsmagok között. A "Get" parancsmag például az adatokat lekért parancsmagok esetén használható.

A parancsokkal kapcsolatos útmutatásokkal kapcsolatos további információkért lásd: Parancsmagok parancsmagneveinek nevei. A parancsmagok neveiben nem használható speciális karakterek listájáért lásd: Required Development Guidelines (Szükséges fejlesztési irányelvek).

A Windows PowerShell támogatása

A Parancsmag attribútummal azt is megadhatja, hogy a parancsmag támogatja-e a parancsmagok által biztosított Windows PowerShell. Ez magában foglalja a gyakori funkciók támogatását, például a felhasználói visszajelzések megerősítését (a ShouldProcess szolgáltatás támogatását) és a tranzakciók támogatását. (A tranzakciók támogatása a 2.0 Windows PowerShell ban lett bevezetve.

A Parancsmag attribútum megadásához használt deklaráció szintaxisával kapcsolatos további információkért lásd: Parancsmag-attribútumdeklaráció.

Parancsmagosztály definíciója

Az alábbi kód a GetProc parancsmagosztály definíciója. Figyelje meg, hogy a rendszer a Casing parancsmagot használja, és hogy az osztály neve tartalmazza a parancsmag parancsmagját és főnevét.

[Cmdlet(VerbsCommon.Get, "Proc")]
public class GetProcCommand : Cmdlet

Casing (Casing)

A parancsmagok elnevezésekor használja a Casing (Bemenet) kis- és kis- és kis- és bevezetőt. A és a parancsmag például a kis- és nagybetűk használatának helyes módját mutatja a parancsmagok Get-Item Get-ItemProperty elnevezése során.

Lásd még:

System.Management.Automation.CmdletAttribute

CmdletAttribute-deklaráció

Parancsmagok parancsmagnevei

Windows PowerShell-parancsmag írása

Windows PowerShell SDK