Yardım sistemini kullanarak komut bulma

  • 1 dakika

PowerShell'deki yerleşik yardım sistemini kullanarak belirli bir komut hakkında daha fazla bilgi edinebilirsiniz. İhtiyacınız olan Get-Command bir komutu bulmak için cmdlet'ini kullanırsınız. Komutu bulduktan sonra, komutun ne yaptığı ve bunu çağırmanın çeşitli yolları hakkında daha fazla bilgi edinmek isteyebilirsiniz.

Yardım sistemini ve Get-Help'i kullanarak cmdlet'leri bulma

Bir komut hakkında daha fazla bilgi edinmek için çekirdek cmdlet'ini kullanabilirsiniz Get-Help . Genellikle, adıyla belirterek ve hakkında bilgi edinmek istediğiniz cmdlet'in adını içeren bayrağı ekleyerek -Name çağırırsınızGet-Help. Bir örnek aşağıda verilmiştir:

Get-Help -Name Get-Help

Güncelleştirme yardımı

PowerShell'in yeni sürümleri varsayılan olarak yardım sistemini içermez. uygulamasını ilk kez çalıştırdığınızda Get-Helpyardım dosyalarını yüklemeniz istenir. Yardım dosyalarını yüklemek için cmdlet'ini de çalıştırabilirsiniz Update-Help . Çağrı Update-Help çok sayıda yardım dosyasını indirdiğinden, komut varsayılan olarak günde yalnızca bir kez getirilebilir. Bayrağını kullanarak -Force bu getirme davranışını geçersiz kılabilirsiniz.

Windows'ta yardım dosyalarını Linux veya macOS ile karşılaştırıldığında farklı şekilde güncelleştirirsiniz. cmdlet'ini çalıştırdığınızda yardım dosyalarının bilgisayarınızın Update-Help kültürüyle eşleştirilerek İnternet üzerinden getirildiği için işlem farklılık gösterir. Windows'ta bir kültür zaten yüklüdür, ancak Linux ve macOS'ta eksiktir. Bu nedenle, Linux ve macOS'ta yardım dosyalarını güncelleştirirken bir kültür belirtmeniz gerekir.

Aşağıda örnek bir komut verilmişti:

Update-Help -UICulture en-US -Verbose

Bu komut bayrağını -UICulture belirtir. Abd İngilizcesi yardım dosyalarını getiren değerini en-USverir. macOS veya Linux'ta yardım dosyalarınızı güncelleştirmek için makinenizin kültürüne karşılık gelen bir kültür kullanın.

Yardım bölümlerini keşfedin

Bir cmdlet'inde çağırdığınızda Get-Help bir yardım sayfası döndürülür. Sayfada birçok bölüm vardır. Büyük olasılıkla şu yaygın bölümleri görürsünüz:

  • AD: Komutun adını sağlar.
  • SÖZ DIZIMİ: Bayrakların ve bazen izin verilen parametrelerin birleşimini kullanarak komutu çağırmanın yollarını gösterir.
  • ALIASES: Bir komutun diğer adlarını listeler. Diğer ad, komut için farklı bir addır ve komutu çağırmak için kullanılabilir.
  • NOTLAR: Bu komutla ilgili daha fazla yardım almak için çalıştırılacak komutlar hakkında bilgi sağlar.
  • PARAMETRELER: Parametresiyle ilgili ayrıntıları sağlar. Türü, daha uzun bir açıklama ve varsa kabul edilebilir değerleri listeler.

Yardım yanıtını filtreleme

Yardım sayfasının tamamını görüntülemek istemiyorsanız, komutunuza Get-Help bayraklar ekleyerek yanıtı daraltın. Kullanabileceğiniz bazı bayraklar şunlardır:

  • Tam: Ayrıntılı bir yardım sayfası döndürür. Standart yanıtta almadığınız parametreler, girişler ve çıkışlar gibi bilgileri belirtir.
  • Ayrıntılı: Standart yanıt gibi görünen ancak parametreler için bir bölüm içeren bir yanıt döndürür.
  • Örnekler: Varsa yalnızca örnekleri döndürür.
  • Çevrimiçi: Komutunuz için bir web sayfası açar.
  • Parametre: Bağımsız değişken olarak bir parametre adı gerektirir. Belirli bir parametrenin özelliklerini listeler.

Örneğin, yardım sayfasının yalnızca Örnekler bölümünü döndürmek için aşağıdaki komutu kullanabilirsiniz.

Get-Help Get-FileHash -Examples

Okuma deneyimini geliştirme

Çalıştırma Get-Help , yardım sayfasının tamamını döndürür. Sayfa en iyi okuma deneyimini sağlamayabilir. Okumak istediğiniz bölümü bulmak için ekranı kaydırmanız gerekebilir. Diğer adı kullanmak help daha iyi bir yaklaşımdır. Diğer help ad, Get-Help çıkışınızın satır satır okunabilir olmasını sağlayan bir işleve bağlanır. Ayrıca, çıkışı sayfalayarak yanıtı sayfa sayfa okunabilir hale getirir. Diğer adı bir sonraki ünitede kullanacaksınız help .