13. Cmdlet'ler

Editör notu

Önemli

Windows PowerShell Dil Belirtimi 3.0 Aralık 2012'de yayımlanmıştır ve Windows PowerShell 3.0'ı temel alır. Bu belirtim PowerShell'in geçerli durumunu yansıtmaz. Bu belgeleri geçerli durumu yansıtacak şekilde güncelleştirme planı yoktur. Bu belgeler, geçmişe yönelik başvuru için burada sunulmuştur.

Belirtim belgesi, Şu konumdaki Microsoft İndirme Merkezi'nden bir Microsoft Word belgesi olarak kullanılabilir: https://www.microsoft.com/download/details.aspx?id=36389 Bu Word belgesi burada Microsoft Learn'de sunu için dönüştürülmüştür. Dönüştürme sırasında, Docs platformu için biçimlendirmeye uyum sağlamak için bazı editoryal değişiklikler yapılmıştır. Bazı yazım hataları ve küçük hatalar düzeltildi.

Cmdlet, PowerShell'deki nesneleri işleyen tek özellikli bir komutdur. Cmdlet'ler ad biçimleri, tire (-) ile ayrılmış bir fiil ve isim ile tanınabilir; örneğin, Get-Help, Get-Processve Start-Service. fiil kalıbı, W*gibi joker karakterler kullanılarak ifade edilen bir fiil kalıbıdır. isim deseni, olaygibi joker karakterler kullanılarak ifade edilen bir isimdir.

Cmdlet'ler basit olmalı ve diğer cmdlet'lerle birlikte kullanılacak şekilde tasarlanmalıdır. Örneğin, Get cmdlet'leri yalnızca veri almalıdır cmdlet'leri yalnızca veri oluşturmalıdır veya değiştirmelidir; Biçim cmdlet'leri yalnızca verileri biçimlendirmelidir ve Out cmdlet'leri çıkışı yalnızca belirtilen bir hedefe yönlendirmelidir.

Her cmdlet için, yazarak erişilebilen bir yardım dosyası sağlayın:

Get-Help *cmdlet-name* -Detailed

Cmdlet yardım dosyasının ayrıntılı görünümü cmdlet'in açıklamasını, komut söz dizimini, parametrelerin açıklamalarını ve bu cmdlet'in kullanımını gösteren bir örneği içermelidir.

Cmdlet'ler işletim sistemi komutlarına ve yardımcı programlarına benzer şekilde kullanılır. PowerShell komutları harf büyüklüğüne duyarlı değildir.

Dikkat

Düzenleyicinin notu: Özgün belgede açıklamalar, söz dizimi diyagramları, parametre tanımları ve örnekler içeren bir cmdlet listesi bulunur. Bu bilgiler eksik ve tarihi geçmiştir. Cmdlet hakkında güncel bilgiler içinPowerShell belgelerinin Başvuru bölümüne bakın.

13.1 Ortak parametreler

ortak parametreleri, herhangi bir cmdlet ile kullanılabilen bir cmdlet parametreleri kümesidir. Bunlar, cmdlet geliştiricisi tarafından değil PowerShell çalışma zamanı ortamı tarafından uygulanır ve Parametre özniteliğini (§12.3.7) veya cmdletBinding özniteliğini (§12.3.5) kullanan herhangi bir cmdlet veya işlev için otomatik olarak kullanılabilir.

Ortak parametreler herhangi bir cmdlet tarafından kabul edilmiş olsa da, bu cmdlet için herhangi bir semantiği olmayabilir. Örneğin, bir cmdlet herhangi bir ayrıntılı çıktı oluşturmazsa, Ayrıntılı genel parametresinin kullanılması bir etki yaratmaz.

Birçok yaygın parametre, tercih değişkenleri aracılığıyla ayarlanabilen sistem varsayılanlarını veya tercihlerini geçersiz kılar (§2.3.2.3). Tercih değişkenlerinden farklı olarak, ortak parametreler yalnızca kullanıldıkları komutları etkiler.

Dikkat

Düzenleyicinin notu: Özgün belge Ortak Parametrelerin listesini içerir. Bu bilgiler eksik ve tarihi geçmiştir. Geçerli bilgiler için bkz. about_CommonParameters.