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
Geri Bildirim
Gönderin ve geri bildirimi görüntüleyin