Yeni Başlayanlar için PowerShell (Bölüm 4): PowerShell Yardımı (Yardım Alın)

Şimdi, Yeni Başlayanlar İçin PowerShell (Bölüm 3): Parametreler başlıklı üçüncü bölümden sonra PowerShell yardımına odaklanacağız. Ancak üçüncü alıştırmanın cevabına başlamadan önce. Ayrıca şu ana kadar öğrendiklerimizi hızlı bir şekilde gözden geçireceğiz.

Serinin tüm bölümlerini burada bulabilirsiniz: Yeni Başlayanlar için PowerShell (Seri)

İnceleme (Bölüm 3)

Egzersiz yapmak

Üçüncü bölümde bu komutun neden çalışmadığını sordum:

Bu komut neden çalışmıyor?

İlk görev *.txt filtresi ve C:\Temp yolu için parametreleri bulmaktır.

Get-Help Get-ChildItem -Parameter *

Yolu ve filtre parametresini bulduğumuzda bunların konumsal olduğunu görebiliriz.

Bu, Yol'un parametre adını gerektirmediği anlamına gelir (aksi takdirde konum değerinin adlandırılması gerekir), ancak parametre değerinin komuttaki ilk veya tek adsız parametre değeri olması gerekir. Bu aynı zamanda çağrının ilk bağımsız değişkeninin otomatik olarak yol parametresine bağlanacağı anlamına da gelir. Ancak ilk argümanımız yolu değil filtreyi (*.txt) tanımlar. Bu işe yarar çünkü yolun değeri birinci konumda ve filtrenin değeri ikinci konumdadır:

Get-ChildItem C:\Temp\ *.txt

Özet

Parametreler farklıdır. Gerekli, konumsal, anahtarlanmış, zorunlu ve zorunlu olmayan parametreler vardır. Get-Help, bir komutun tüm parametrelerini keşfetmenize yardımcı olabilir. Bunu yapmak için Get-Help Your-Command -Parameter * komutunu çalıştırın. Mümkün olduğunda TAB'ı kullanın.

Başlangıçta PowerShell Yardımı hakkında birkaç söz

Parametreleri keşfetmek için yardımın nasıl kullanılacağını zaten öğrendik. Şimdi ileriye doğru büyük bir adım atıyoruz. Bu bölüm tamamen yardım ve yardımın kullanılmasıyla ilgilidir. PowerShell yardımı, yeni şeyler öğrenmek ve keşfetmek için harika bir kaynaktır. Yardıma aşina değilseniz asla iyi bir PowerShell uzmanı olamayacağınıza gerçekten inanıyorum.

"PowerShell'i bir ay öğle yemeğinde öğrenin" kitabının yazarı ve PowerShell MVP'si Don Jones şunları söyledi:

“Yardımı okumaya hazır olun, yoksa PowerShell'de başarısız olursunuz. ”

Yardımı Get-Help cmdlet'iyle çağırabilirsiniz. Bu, yardımın ayrıntılı sürümünün yalnızca çevrimiçi olarak mevcut olduğu konusunda sizi bilgilendirir. Ancak iyi haber şu ki: İndirebiliyorsunuz.

Çevrimiçi yardım

Yardım dosyalarını daha sonra indireceğiz. Bir geçici çözüm var. Get-ChildItem komutunun tam yardımını kullanmak için

Get-Help Get-ChildItem -Online

Çalıştırıldığında sizi Microsoft PowerShell Çevrimiçi Yardımına yönlendiren bir tarayıcı penceresi görünür.

Aşağıdaki örneklere göz atmakta fayda var. Onlar büyük.

Örnekler ve ayrıntılı yardım, Windows çalıştıran bilgisayarlarda varsayılan olarak saklanmaz. Şimdi yardım dosyalarını çevrimiçi bir depodan indireceğiz.

Gözden geçirmek

PowerShell, inceltilmiş bir Yardımla birlikte gönderilir. Kapsamlı bir Çevrimiçi Yardım mevcuttur. Örnekler yardımın kalbidir. Get-Help Your-Command -Online, çevrimiçi yardımı bir web tarayıcısında açar.

Tam Yardımın İndirilmesi

Yardımı indirmek için Güncelleme-Yardım'ı kullanın. Bu, kültür en-US (İngilizce) için yardım dosyalarının nasıl indirileceğine bir örnektir. Windows PowerShell'i açın. Koşmak

Update-Help -UICulture 'en-US' -Force

Lütfen -Force olmadan komutu IP Adresi başına günde yalnızca bir kez çalıştırabileceğinizi unutmayın. Bu nedenle, aşırı yük modunda (PAT) adresleri çevirmek üzere yapılandırılmış bir NAT cihazının arkasındaysanız, tüm istemciler internete aynı genel IP Adresi ve indirmeyle gittiği için Force parametresini sağlamanız gerektiğini unutmayın. bu genel IP Adresine günde bir kez izin verilir.

Artık yardımın tam kapsamı yüklenmiştir. Onunla oynamanın zamanı geldi.

Yardımı Kullanma

Get-Help geniş bir parametre yelpazesi sunar. Get-Help yazın ve ardından - yazıp CTRL + tuşunu basılı tutun Hepsini görmek için BOŞLUK'a basın.

Get-ChildItem türünün yardım içeriğini almak için

Get-Help Get-ChildItem

veya

Help Get-ChildItem

Not: Help, Get-Help'in takma adıdır.

Bu Yardımın küçük versiyonunu gösterir. Yeni başlayanlar için yardımı bu şekilde okumak sinir bozucu olabilir. Komutun kullanımına ilişkin hiçbir örnek ve ayrıntılı bilgi sunmaz. “Yaparak öğrenme” konusunda daha kullanışlı olan Örnek Parametre ile devam edelim.

Şu ana kadar ne öğrendik?

Yardımın tamamı Güncelleme-Yardım komutu kullanılarak indirilir. Help, Get-Help'in takma adıdır. Get-Help'i herhangi bir parametre olmadan çalıştırmak size yardımın küçük versiyonunu gösterir.

Yararlı bir parametre: ShowWindow

Açılır pencereyi tercih ediyorsanız ShowWindow parametresini kullanın.

Get-Help Get-ChildItem -ShowWindow

Örnekler

PowerShell yardım örnekleri, PowerShell ile ilk adımlarınızı atmak için gerçekten harika ve son derece uygun bir kaynaktır. Get-ChildItem örnek türünü almak için

Get-Help Get-ChildItem -Examples

Başka bir örnek, Powershell Niteliklerinin Get-Date ile nasıl kullanılacağını gösterir. Bunu henüz öğrenemedik. Ama bu kırık bir bacak değil, tadına bakabiliriz.

Help Get-Date -Examples

Aşağı kaydırıp Örnek 4'ü arayın.

Artık oynamaya başlayabilirsiniz. Örneğin, komutu değiştirebilir ve doğum tarihinizi girebilirsiniz.

İpucu: (Get-Date) yazın ve ardından CTRL + SPACE tuşlarına basın. Get-Date'in özelliklerini keşfederken eğlenin.

Artık istemeden nesnelere ve niteliklere ulaştık. Bu, bu gönderinin bir parçası değil, daha sonraki bir aşamada gelecek, ama neden onunla oynamayasınız? En baştan başlayacağıma söz verdim. Ama şimdi size bu serinin gelecek bölümlerinde sizi neler bekliyor küçük bir ön bilgi vermek istiyorum:

Örnekler:

(Get-Date -Year 1976 -Month 03 -Date 23).IsDaylightSavingTime()

(Get-Date).AddDays(300)

Gözden geçirmek

Örnekler, PowerShell'i yaparak öğrenerek öğrenmek için harika bir kaynaktır. Çevrimiçi yardım veya örnekler parametresi kullanılarak görüntülenebilirler. Bunu yapmak için Get-Help Your-Command -Examples komutunu çalıştırın.

Tam Yardım

Tam yardım çalıştırmak için

Get-Help Get-Date -Full

Tam yardım, yardım konusunun tamamını görüntüler. Bu, parametreleri, nitelikleri ve son olarak örnekleri içerir.

Ayrıntılı Yardım

Ayrıntılı parametresi ile Get-Help, parametre açıklamalarını ve örneklerini gösterir.

Get-Help Get-Date -Detailed

Şu ana kadar ne öğrendik?

Tam yardım, yardım konusunun tamamını görüntüler. Ayrıntılı yardım, ayrıntılı parametre açıklamalarını ve örneklerini gösterir. Ve bir kez daha şunu yeterince sık dile getiremiyorum: Örnekler en önemlileridir.

Yardım dosyalarının konumu

İndirilen yardım dosyalarını şu adreste bulabilirsiniz:

C:\Windows\System32\WindowsPowerShell\v1.0\en-US\

Dosya adı Microsoft.PowerShell.Commands.Management.dll-Help.xml'dir.

Bu yardım dosyası PowerShell'de de görüntülenebilir:

(Get-Command Get-ChildItem).Helpfile

Veya yardım dosyalarını Get-Help ile görüntüleyin. Üçüncü bölümde Parametreleri ele aldık. Parametrelerle ilgili dosyayı burada bulabilirsiniz (C:\Windows\System32\WindowsPowerShell\v1.0\en-US\ konumunda)

Get-Help about_Parameters

Gözden geçirmek

Yardım dosyaları belirli bir Windows klasöründe bulunur C:\Windows\System32\WindowsPowerShell\v1.0\en-US

Microsoft Dokümanlarında PowerShell yardımı hakkında daha fazla bilgi edinin: https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/get-help?view=powershell-5.1

Bugünlük bu kadar. Umarım keyif almışsınızdır! İşte bir dahaki sefere kadar egzersiz.

Egzersiz yapmak

Uygulama Kurallarımızı unutmayın:

Kendiniz yapın. Kendi başınıza yapmadığınız her şey kısa sürede unutulacaktır.

Komut başlatma işleminin 4. yardım örneği nedir? Bulduktan sonra bilgisayarınızda çalıştırın!

Çözümü bir sonraki bölümde bulabilirsiniz.

Bir sonraki makalede görüşmek üzere Yeni Başlayanlar için PowerShell (Bölüm 5): Yürütme Politikası (ps1 Dosyaları)

Patrick Gruenauer, PowerShell'in MVP'si