Cmdlet Sınıf Bildirimi

Microsoft .NET Framework sınıfı, cmdlet özniteliği sınıf için meta veri olarak belirterek cmdlet olarak bildirildi. (Cmdlet özniteliği, tüm cmdlet'ler için gereken tek özniteliktir). Cmdlet özniteliğini belirttiğinizde, cmdlet'i kullanıcıya tanımlayan fiil-ve-ad çiftini belirtmeniz gerekir. Ayrıca cmdlet'in Windows PowerShell işlevlerini açıklamalısiniz. Cmdlet özniteliğini belirtmek için kullanılan bildirim söz dizimi hakkında daha fazla bilgi için bkz. Cmdlet Öznitelik Bildirimi.

Not

Cmdlet özniteliği System.Management.Automation.CmdletAttribute sınıfı tarafından tanımlanır. Bu sınıfın özellikleri, özniteliğini bildirirken kullanılan bildirim parametrelerine karşılık gelir.

İsimler

cmdlet'ini, cmdlet'in üzerinde eylemde bulunan kaynakları belirtir. bu, cmdlet'lerinizi diğer cmdlet'lerden ayırt ediyor.

Cmdlet adlarında isimler belirli olmalıdır ve sunucu gibi genel isimlerde kaynağınızı diğer benzer kaynaklardan ayıran kısa bir ön ek eklemek en iyisidir. Örneğin, ön eke sahip bir isim içeren bir cmdlet adı Get-SQLServer olur. Belirli bir adın daha genel bir fiil ile birleşimi, kullanıcının cmdlet'i eylemiyle hızla bulmasını ve ardından cmdlet'i kaynağına göre tanımlamasını ve gereksiz cmdlet adı yinelemesini önlemesini sağlar.

cmdlet adlarında kullanılam özel karakterlerin listesi için bkz. Gerekli Geliştirme Yönergeleri.

Fiiller

Bir fiil belirttiğinizde, geliştirme yönergeleri tarafından sağlanan önceden tanımlanmış fiillerden birini Windows PowerShell. Bu önceden tanımlanmış fiillerden birini kullanarak, yazıldığı cmdlet'ler ile Microsoft tarafından ve başkaları tarafından yazılan cmdlet'ler arasında tutarlılık sağlar. Örneğin, veri alan cmdlet'ler için "Get" fiili kullanılır.

Fiil yönergeleri hakkında daha fazla bilgi için bkz. Cmdlet Fiil Adları. cmdlet adlarında kullanılam özel karakterlerin listesi için bkz. Gerekli Geliştirme Yönergeleri.

Destek Windows PowerShell İşlevselliği

Cmdlet özniteliği ayrıca cmdlet'inizin, cmdlet'iniz tarafından sağlanan bazı yaygın işlevleri desteklediğini belirtmenize Windows PowerShell. Buna kullanıcı geri bildirimi onayı (ShouldProcess özelliği için destek olarak adlandırılır) ve işlemler için destek gibi yaygın işlevler için destek dahildir. (İşlemler için destek, Windows PowerShell 2.0'da tanıtıldı).

Cmdlet özniteliğini belirtmek için kullanılan bildirim söz dizimi hakkında daha fazla bilgi için bkz. Cmdlet Öznitelik Bildirimi.

Cmdlet Sınıf Tanımı

Aşağıdaki kod bir GetProc cmdlet sınıfının tanımıdır. Pascal büyük/sn'nin kullanılmış olduğunu ve sınıfın adının cmdlet'in fiil ve isim olduğunu fark ettik.

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

Pascal Casing

cmdlet'leri olarak adlarken Pascal büyük/büyük/yeni bir ad kullanın. Örneğin, Get-Item ve Get-ItemProperty cmdlet'leri, cmdlet'leri adlandırıyorken büyük/büyük harf kullanımının doğru yolunu gösterir.

Ayrıca Bkz.

System.Management.Automation.CmdletAttribute

CmdletAttribute Bildirimi

Cmdlet Fiil Adları

Windows PowerShell Cmdlet’ini Yazma

Windows PowerShell SDK’sı