Aracılığıyla paylaş

PowerShell Komutları için Onaylanan Fiiller

PowerShell, cmdlet'lerin adları ve türetilmiş .NET sınıfları için bir fiil-isim çifti kullanır. Adın fiil bölümü, cmdlet'in gerçekleştirdiği eylemi tanımlar. Adın isim bölümü, eylemin gerçekleştirildiği varlığı tanımlar. Örneğin, Get-Command cmdlet'i PowerShell'de kayıtlı tüm komutları alır.

Uyarı

PowerShell, İngilizce dilinde standart bir fiil olmasa bile eyleme işaret eden bir sözcüğü açıklamak için fiil terimini kullanır. Örneğin, terim New geçerli bir PowerShell fiil adıdır çünkü İngilizce dilinde bir fiil olmasa bile bir eylem anlamına gelir.

Onaylanan her fiilin karşılık gelen bir diğer ad ön eki vardır. Bu diğer ad ön eklerini, bu fiili kullanan komutlar için diğer adlarda kullanırız. Örneğin, Import diğer adı öneki ip ve buna göre Import-Module diğer adı ipmo. Bu bir öneridir ancak kural değildir; özellikle, diğer ortamlardaki iyi bilinen komutları taklit eden komut diğer adları için dikkate alınması gerekmez.

Fiil Adlandırma Önerileri

Aşağıdaki öneriler, oluşturduğunuz cmdlet'ler, PowerShell tarafından sağlanan cmdlet'ler ve başkaları tarafından tasarlanan cmdlet'ler arasında tutarlılık sağlamak üzere cmdlet'iniz için uygun bir fiil seçmenize yardımcı olur.

  • PowerShell tarafından sağlanan önceden tanımlanmış fiil adlarından birini kullanın
  • Eylemin genel kapsamını açıklamak için fiilini kullanın ve cmdlet'in eylemini daha da daraltmak için parametreleri kullanın.
  • Onaylanan fiilin eş anlamlısı kullanmayın. Örneğin, her zaman Removekullanın, hiçbir zaman Delete veya Eliminatekullanmayın.
  • Yalnızca bu konuda listelenen her fiilin biçimini kullanın. Örneğin, kullanınGet, ancak veya GettingkullanmayınGets.
  • Aşağıdaki ayrılmış fiilleri veya diğer adları kullanmayın. PowerShell dili ve nadir birkaç cmdlet bu fiilleri istisnai durumlarda kullanır.
    • ForEach (foreach)
    • Ping (pi)
    • Sort (sr)
    • Tee (te)
    • Where (wh)

Get-Verb cmdlet'ini kullanarak fiillerin tam listesini alabilirsiniz.

Farklı Eylemler için Benzer Fiiller

Aşağıdaki benzer fiiller farklı eylemleri temsil ediyor.

New ile Add karşılaştırması

Yeni bir kaynak oluşturmak için New fiilini kullanın. Var olan bir kapsayıcıya veya kaynağa bir şey eklemek için Add kullanın. Örneğin, Add-Content var olan bir dosyaya çıkış ekler.

New ile Set karşılaştırması

Yeni bir kaynak oluşturmak için New fiilini kullanın. Set Var olan bir kaynağı değiştirmek için fiili kullanın; isteğe bağlı olarak Set-Variable mevcut değilse oluşturun( örneğin, cmdlet).

Nesne aramak için Find fiilini kullanın. Kapsayıcıdaki bir kaynağa başvuru oluşturmak için Search fiilini kullanın.

Get ile Read karşılaştırması

Bir kaynak (dosya gibi) hakkında bilgi almak veya gelecekte kaynağa erişebileceğiniz bir nesne elde etmek için Get fiilini kullanın. Bir kaynağı açmak ve içinde yer alan bilgileri ayıklamak için Read fiilini kullanın.

Invoke ile Start karşılaştırması

Komut çalıştırma ve bitmesini bekleme gibi zaman uyumlu işlemler gerçekleştirmek için Invoke fiilini kullanın. Otonom bir işlem başlatma gibi zaman uyumsuz işlemleri başlatmak için Start fiilini kullanın.

Ping ile Test karşılaştırması

Test fiilini kullanın.

Ortak Fiiller

PowerShell, neredeyse tüm cmdlet'lere uygulanabilecek genel eylemleri tanımlamak için System.Management.Automation.VerbsCommon numaralandırma sınıfını kullanır. Aşağıdaki tabloda tanımlı fiillerin çoğu listelanmaktadır.

Fiil (diğer ad) Eylem Kaçınılması gereken eş anlamlılar
Add (a) Kapsayıcıya kaynak ekler veya bir öğeyi başka bir öğeye ekler. Örneğin, Add-Content cmdlet'i bir dosyaya içerik ekler. Bu fiil Removeile eşleştirilir. Ekleme, Ekleme, Birleştirme, Ekleme
Clear (cl) Kapsayıcıdaki tüm kaynakları kaldırır ancak kapsayıcıyı silmez. Örneğin, Clear-Content cmdlet bir dosyanın içeriğini kaldırır ancak dosyayı silmez. Temizleme, Silme, Serbest Bırakma, İşareti Kaldırma, Kümeyi Kaldırma, NullLeştirme
Close (cs) Kaynağın durumunu değiştirerek erişilemez, kullanılamaz veya kullanılamaz duruma getirir. Bu fiil Open.
Copy (cp) Kaynağı başka bir ada veya başka bir kapsayıcıya kopyalar. Örneğin, Copy-Item cmdlet'i bir öğeyi (dosya gibi) veri deposundaki bir konumdan başka bir konuma kopyalar. Çoğaltma, Kopyalama, Çoğaltma, Eşitleme
Enter (et) Kullanıcının kaynağa geçiş yapmasına olanak tanıyan bir eylem belirtir. Örneğin, Enter-PSSession cmdlet'i kullanıcıyı etkileşimli bir oturuma yerleştirir. Bu fiil Exitile eşleştirilir. gönder, içine
Exit (ex) Geçerli ortamı veya bağlamı en son kullanılan bağlama ayarlar. Örneğin, Exit-PSSession cmdlet'i kullanıcıyı etkileşimli oturumu başlatmak için kullanılan oturuma yerleştirir. Bu fiil Enterile eşleştirilir. Açılan, Çıkış
Find (fd) Kapsayıcıda bilinmeyen, örtük, isteğe bağlı veya belirtilen bir nesneyi arar. Arama yap
Format (f) Nesneleri belirtilen bir formda veya düzende düzenler
Get (g) Bir kaynağı alan eylemi belirtir. Bu fiil Setile eşleştirilir. Okuma, Açma, Kedi, Tür, Dir, Alma, Döküm, Alma, İnceleme, Bulma, Arama
Hide (h) Bir kaynağı algılanamaz hale getirir. Örneğin, adında Gizle fiilini içeren bir cmdlet bir hizmeti bir kullanıcıdan gizleyebilir. Bu fiil Showile eşleştirilir. Blok
Join (j) Kaynakları tek bir kaynakta birleştirir. Örneğin, Join-Path cmdlet'i bir yolu alt yollarından biriyle birleştirerek tek bir yol oluşturur. Bu fiil Splitile eşleştirilir. Birleştir, Birleştir, Bağlan, İlişkile
Lock (lk) Bir kaynağın güvenliğini sağlar. Bu fiil Unlockile eşleştirilir. Kısıtla, Güvenli
Move (m) Bir kaynağı bir konumdan diğerine taşır. Örneğin, Move-Item cmdlet'i bir öğeyi veri deposundaki bir konumdan başka bir konuma taşır. Aktarım, Ad, Geçiş
New (n) Bir kaynak oluşturur. (Set fiili, Set-Variable cmdlet'i gibi verileri içeren bir kaynak oluştururken de kullanılabilir.) Oluşturma, Oluşturma, Derleme, Oluşturma, Ayırma
Open (op) Kaynağın durumunu değiştirerek erişilebilir, kullanılabilir veya kullanılabilir hale getirir. Bu fiil Closeile eşleştirilir.
Optimize (om) Kaynağın verimliliğini artırır.
Pop (pop) Bir öğeyi yığının üst kısmından kaldırır. Örneğin, Pop-Location cmdlet'i geçerli konumu yığına en son gönderilen konuma değiştirir.
Push (pu) Yığının en üstüne öğe ekler. Örneğin, Push-Location cmdlet'i geçerli konumu yığına iter.
Redo (re) Bir kaynağı geri alınan duruma sıfırlar.
Remove (r) Kapsayıcıdan bir kaynağı siler. Örneğin, Remove-Variable cmdlet'i bir değişkeni ve değerini siler. Bu fiil Addile eşleştirilir. Temizle, Kes, At, At, Sil
Rename (rn) Kaynağın adını değiştirir. Örneğin, depolanan verilere erişmek için kullanılan Rename-Item cmdlet'i, veri deposundaki bir öğenin adını değiştirir. Değişiklik
Reset (rs) Bir kaynağı özgün durumuna geri ayarlar.
Resize(rz) Kaynağın boyutunu değiştirir.
Search (sr) Kapsayıcıdaki bir kaynağa başvuru oluşturur. Bul, Bul
Select (sc) Kapsayıcıdaki bir kaynağı bulur. Örneğin, Select-String cmdlet'i dizelerde ve dosyalarda metin bulur. Bul, Bul
Set (s) Mevcut bir kaynak üzerindeki verileri değiştirir veya bazı veriler içeren bir kaynak oluşturur. Örneğin, Set-Date cmdlet'i yerel bilgisayardaki sistem saatini değiştirir. (kaynak oluşturmak için New fiili de kullanılabilir.) Bu fiil Getile eşleştirilir. Yazma, Sıfırlama, Atama, Yapılandırma, Güncelleştirme
Show (sh) Bir kaynağın kullanıcıya görünür olmasını sağlar. Bu fiil Hideile eşleştirilir. Görüntüle, Üret
Skip (sk) Bir dizideki bir veya daha fazla kaynağı veya noktayı atlar. Atla, Atla
Split (sl) Kaynağın bölümlerini ayırır. Örneğin, Split-Path cmdlet'i bir yolun farklı bölümlerini döndürür. Bu fiil Joinile eşleştirilir. Ayırmak
Step (st) Bir dizideki bir sonraki noktaya veya kaynağa geçer.
Switch (sw) İki konum, sorumluluk veya durum arasında değişiklik yapmak gibi iki kaynak arasında değişen bir eylem belirtir.
Undo (un) Bir kaynağı önceki durumuna ayarlar.
Unlock (uk) Kilitli olan bir kaynağı serbest bırakır. Bu fiil Lockile eşleştirilir. Yayın, Sınırsız, Güvensiz
Watch (wc) Bir kaynağı sürekli olarak inceler veya değişiklikler için izler.

İletişim Fiilleri

PowerShell, iletişimler için geçerli eylemleri tanımlamak için System.Management.Automation.VerbsCommunications sınıfını kullanır. Aşağıdaki tabloda tanımlı fiillerin çoğu listelanmaktadır.

Fiil (diğer ad) Eylem Kaçınılması gereken eş anlamlılar
Connect (cc) Kaynak ile hedef arasında bağlantı oluşturur. Bu fiil Disconnectile eşleştirilir. Katılma, Telnet, Oturum Açma
Disconnect (dc) Kaynak ve hedef arasındaki bağlantıyı keser. Bu fiil Connectile eşleştirilir. Kesme, Kapatma
Read (rd) Bir kaynaktan bilgi alır. Bu fiil Writeile eşleştirilir. Alma, İstem, Alma
Receive (rc) Bir kaynaktan gönderilen bilgileri kabul eder. Bu fiil Sendile eşleştirilir. Okuma, Kabul Etme, Göz Atma
Send (sd) Bilgileri bir hedefe teslim eder. Bu fiil Receiveile eşleştirilir. Koy, Yayın, Posta, Faks
Write (wr) Hedefe bilgi ekler. Bu fiil Readile eşleştirilir. Koy, Yazdır

Veri Fiilleri

PowerShell, veri işlemeye uygulanan eylemleri tanımlamak için System.Management.Automation.VerbsData sınıfını kullanır. Aşağıdaki tabloda tanımlı fiillerin çoğu listelanmaktadır.

Fiil Adı (diğer ad) Eylem Kaçınılması gereken eş anlamlılar
Backup (ba) Verileri çoğaltarak depolar. Kaydet, Yazdır, Çoğalt, Eşitle
Checkpoint (ch) Verilerin geçerli durumunun veya yapılandırmasının anlık görüntüsünü oluşturur. Fark
Compare (cr) Bir kaynaktan alınan verileri başka bir kaynaktan alınan verilerle karşılaştırarak değerlendirir. Fark
Compress (cm) Bir kaynağın verilerini sıkıştırıyor. Expandile çiftler. Kompakt
Convert (cv) Cmdlet çift yönlü dönüştürmeyi desteklediğinde veya cmdlet birden çok veri türü arasında dönüştürmeyi desteklediğinde verileri bir gösterimden diğerine değiştirir. Değiştir, Yeniden Boyutlandır, Yeniden Örnekle
ConvertFrom (cf) Bir birincil giriş türünü (cmdlet adı girişi gösterir) desteklenen bir veya daha fazla çıkış türüne dönüştürür. Dışarı Aktarma, Çıkış, Dışarı Aktarma
ConvertTo (ct) Bir veya daha fazla giriş türünden birincil çıkış türüne dönüştürür (cmdlet adı çıkış türünü belirtir). İçeri Aktarma, Giriş, İçeri Aktarma
Dismount (dm) Adlandırılmış varlığı bir konumdan ayırır. Bu fiil Mountile eşleştirilir. Çıkarma, Bağlantıyı Kaldırma
Edit (ed) İçerik ekleyerek veya kaldırarak mevcut verileri değiştirir. Değiştir, Güncelleştir, Değiştir
Expand (en) Sıkıştırılmış bir kaynağın verilerini özgün durumuna geri yükler. Bu fiil Compressile eşleştirilir. Patla, Sıkıştırmayı Kaldır
Export (ep) Birincil girişi dosya gibi kalıcı bir veri deposuna veya değişim biçimine kapsüller. Bu fiil Importile eşleştirilir. Ayıklama, Yedekleme
Group (gp) Bir veya daha fazla kaynağı düzenler veya ilişkilendirir
Import (ip) Kalıcı bir veri deposunda (dosya gibi) veya değişim biçiminde depolanan verilerden bir kaynak oluşturur. Örneğin, Import-Csv cmdlet virgülle ayrılmış değer (CSV) dosyasındaki verileri diğer cmdlet'ler tarafından kullanılabilecek nesnelere aktarır. Bu fiil Exportile eşleştirilir. BulkLoad, Yük
Initialize (in) Bir kaynağı kullanıma hazırlar ve varsayılan duruma ayarlar. Silme, Başlatma, Yenileme, Yeniden Oluşturma, Yeniden Başlatma, Kurulum
Limit (l) Bir kaynağa kısıtlamalar uygular. Kota
Merge (mg) Birden çok kaynaktan tek bir kaynak oluşturur. Birleştir, Katıl
Mount (mt) Bir konuma adlandırılmış varlık ekler. Bu fiil Dismountile eşleştirilir. Bağlan
Out (o) Verileri ortamdan gönderir. Örneğin, Out-Printer cmdlet'i bir yazıcıya veri gönderir.
Publish (pb) Bir kaynağı başkalarının kullanımına sağlar. Bu fiil Unpublishile eşleştirilir. Dağıtma, Yayımlama, Yükleme
Restore (rr) Kaynağı önceden tanımlanmış bir duruma ayarlar, örneğin Checkpointtarafından ayarlanan bir durum. Örneğin, Restore-Computer cmdlet'i yerel bilgisayarda bir sistem geri yükleme işlemi başlatır. Onar, İade Et, Geri Al, Düzelt
Save (sv) Kaybı önlemek için verileri korur.
Sync (sy) İki veya daha fazla kaynağın aynı durumda olduğundan emin olur. Çoğaltma, Zorlama, Eşleştirme
Unpublish (ub) Bir kaynağı başkaları tarafından kullanılamaz duruma getirir. Bu fiil Publishile eşleştirilir. Kaldırma, Geri Döndürme, Gizleme
Update (ud) Bir kaynağı durumunu, doğruluğunu, uyumluluğunu veya uyumluluğunu korumak için -date up-togetirir. Örneğin, Update-FormatData cmdlet'i geçerli PowerShell konsoluna biçimlendirme dosyalarını güncelleştirir ve ekler. Yenileme, Yenileme, Yeniden Hesaplama, Yeniden Dizin oluşturma

Tanılama Fiilleri

PowerShell, tanılamaya uygulanan eylemleri tanımlamak için System.Management.Automation.VerbsDiagnostic sınıfını kullanır. Aşağıdaki tabloda tanımlı fiillerin çoğu listelanmaktadır.

Fiil (diğer ad) Eylem Kaçınılması gereken eş anlamlılar
Debug (db) operasyonel sorunları tanılamak için bir kaynağı inceler. Tanılamak
Measure (ms) Belirtilen bir işlem tarafından kullanılan kaynakları tanımlar veya bir kaynakla ilgili istatistikleri alır. Hesaplama, Belirleme, Çözümleme
Ping (pi) Kullanım dışı - Bunun yerine Test fiilini kullanın.
Repair (rp) Bir kaynağı kullanılabilir bir koşula geri yükler Düzeltme, Geri Yükleme
Resolve (rv) Bir kaynağın kısa gösterimini daha eksiksiz bir gösterimle eşler. Genişlet, Belirle
Test (t) Bir kaynağın işlemini veya tutarlılığını doğrular. Tanılama, Çözümleme, Kurtarma, Doğrulama
Trace (tr) Bir kaynağın etkinliklerini izler. İzleme, Takip Etme, İnceleme, Kazı

Yaşam Döngüsü Fiilleri

PowerShell, bir kaynağın yaşam döngüsüne uygulanan eylemleri tanımlamak için System.Management.Automation.VerbsLifecycle sınıfını kullanır. Aşağıdaki tabloda tanımlı fiillerin çoğu listelanmaktadır.

Fiil (diğer ad) Eylem Kaçınılması gereken eş anlamlılar
Approve (ap) Bir kaynağın veya işlemin durumunu onaylar veya kabul eder.
Assert (as) Bir kaynağın durumunu doğrular. Tasdik
Build (bd) Bazı giriş dosyaları kümesinden (genellikle kaynak kodu veya bildirim temelli belgeler) bir yapıt (genellikle ikili veya belge) oluşturur. Bu fiil PowerShell 6'ya eklendi.
Complete (cp) Bir işlemi tamamlar.
Confirm (cn) Bir kaynağın veya işlemin durumunu onaylar, doğrular veya doğrular. Kabul Et, Onayla, Doğrula, Doğrula
Deny (dn) Bir kaynağın veya işlemin durumunu reddeder, nesneler, bloklar veya karşıtlık eder. Engelle, Nesne, Reddet, Reddet
Deploy (dp) Bir uygulamayı, web sitesini veya çözümü, dağıtım tamamlandıktan sonra çözümün tüketicisinin erişebileceği şekilde uzak bir hedefe[s] gönderir. Bu fiil PowerShell 6'ya eklendi.
Disable (d) Bir kaynağı kullanılamıyor veya etkin değil durumuna yapılandırıyor. Örneğin, Disable-PSBreakpoint cmdlet'i bir kesme noktasını devre dışı yapar. Bu fiil Enableile eşleştirilir. Durdur, Gizle
Enable (e) Bir kaynağı kullanılabilir veya etkin bir duruma yapılandırıyor. Örneğin, Enable-PSBreakpoint cmdlet'i bir kesme noktasını etkin hale getirir. Bu fiil Disableile eşleştirilir. Başlat, Başla
Install (is) Bir kaynağı bir konuma yerleştirir ve isteğe bağlı olarak başlatır. Bu fiil Uninstallile eşleştirilir. Kurulum
Invoke (i) Komut veya yöntem çalıştırma gibi bir eylem gerçekleştirir. Çalıştır, Başlat
Register (rg) Veritabanı gibi bir depodaki bir kaynak için giriş oluşturur. Bu fiil Unregisterile eşleştirilir.
Request (rq) Bir kaynak ister veya izinler ister.
Restart (rt) Bir işlemi durdurur ve yeniden başlatır. Örneğin, Restart-Service cmdlet'i durur ve bir hizmet başlatır. Geri dönüşüm
Resume (ru) Askıya alınmış bir işlemi başlatır. Örneğin, Resume-Service cmdlet'i askıya alınmış bir hizmeti başlatır. Bu fiil Suspendile eşleştirilir.
Start (sa) bir işlem başlatır. Örneğin, Start-Service cmdlet'i bir hizmet başlatır. Bu fiil Stopile eşleştirilir. Başlatma, Başlatma, Önyükleme
Stop (sp) Bir etkinliği sona erdirir. Bu fiil Startile eşleştirilir. Bitir, Öldür, Sonlandır, İptal Et
Submit (sb) Onay için bir kaynak sunar. Gönderi
Suspend (ss) Etkinliği duraklatır. Örneğin, Suspend-Service cmdlet'i bir hizmeti duraklatır. Bu fiil Resumeile eşleştirilir. Durdur
Uninstall (us) Belirtilen konumdan bir kaynağı kaldırır. Bu fiil Installile eşleştirilir.
Unregister (ur) Bir kaynağın girdisini bir depodan kaldırır. Bu fiil Registerile eşleştirilir. Kaldır
Wait (w) Belirtilen bir olay gerçekleşene kadar işlemi duraklatır. Örneğin, Wait-Job cmdlet'i bir veya daha fazla arka plan işi tamamlanana kadar işlemleri duraklatır. Uyku, Duraklatma

Güvenlik Fiilleri

PowerShell, güvenliğe uygulanan eylemleri tanımlamak için System.Management.Automation.VerbsSecurity sınıfını kullanır. Aşağıdaki tabloda tanımlı fiillerin çoğu listelanmaktadır.

Fiil (diğer ad) Eylem Kaçınılması gereken eş anlamlılar
Block (bl) Kaynağa erişimi kısıtlar. Bu fiil Unblockile eşleştirilir. Engelle, Sınırla, Reddet
Grant (gr) Kaynağa erişime izin verir. Bu fiil Revokeile eşleştirilir. İzin Ver, Etkinleştir
Protect (pt) Bir kaynağı saldırı veya kayıplara karşı korur. Bu fiil Unprotectile eşleştirilir. Şifreleme, Koruma, Mühürleme
Revoke (rk) Bir kaynağa erişime izin vermeyen bir eylem belirtir. Bu fiil Grantile eşleştirilir. Kaldır, Devre Dışı Bırak
Unblock (ul) Bir kaynakla ilgili kısıtlamaları kaldırır. Bu fiil Blockile eşleştirilir. Temizle, İzin Ver
Unprotect (up) Saldırı veya kaybı önlemek için eklenen kaynaktan korumaları kaldırır. Bu fiil Protectile eşleştirilir. Şifre çözme, Korumasız

Diğer Fiiller

PowerShell, ortak, iletişim, veri, yaşam döngüsü veya güvenlik fiil adları fiilleri gibi belirli bir fiil adı kategorisine sığmayan kurallı fiil adlarını tanımlamak için System.Management.Automation.VerbsOther sınıfını kullanır.

Fiil (diğer ad) Eylem Kaçınılması gereken eş anlamlılar
Use (u) Bir şey yapmak için bir kaynak kullanır veya içerir.

Ayrıca Bkz.