PowerShell'de, bir dosyadaki bir işlevi nasıl tanımlayabilir ve PowerShell komut satırından nasıl çağırabilirim?

Özel işlevleri tanımlamak istediğim bir .ps1 dosyası var.

Dosyanın MyFunctions.ps1 olarak adlandırıldığını ve içeriğin aşağıdaki gibi olduğunu düşünün:

Write-Host "Installing functions"
function A1
{
    Write-Host "A1 is running!"
}
Write-Host "Done"

Bu komut dosyasını çalıştırmak ve A1 işlevini teorik olarak kaydetmek için, .ps1 dosyasının bulunduğu klasöre gidip dosyayı çalıştırın:

.\MyFunctions.ps1

Bu çıktılar:

Installing functions
Done

Yine de, A1'i aramaya çalıştığımda, bu adla komut / işlev olmadığını belirten hatayı alıyorum:

The term 'A1' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling
 of the name, or if a path was included, verify that the path is correct and try again.
At line:1 char:3
+ A1 <<<<
    + CategoryInfo          : ObjectNotFound: (A1:String) [], CommandNotFoundException
    + FullyQualifiedErrorId : CommandNotFoundException

Bazı PowerShell kavramlarını yanlış anlamam gerekiyor. Komut dosyalarındaki işlevleri tanımlayamıyorum?

Yürütme ilkemi zaten 'RemoteSigned' olarak ayarladığımı unutmayın . Ve dosya adının önünde bir nokta kullanarak .ps1 dosyalarını çalıştırmayı biliyorum:. \ MyFile.ps1

PowerShell komut satırında bunu deneyin:

. .\MyFunctions.ps1
A1

Nokta işleci, script içerme için kullanılır.

Bahsettiğiniz konuya nokta kaynağı denir . Ve bu kötü. Ancak endişelenmenize gerek yok, modüller ile ne yapmak istediğinizi yapmanın daha iyi ve daha kolay bir yolu var (olduğundan daha korkutucu geliyor). Modül kullanmanın en büyük yararı, gerektiğinde bunları kabuktan kaldırabilmenizdir ve işlevlerdeki değişkenlerin kabuğa sürünmesini engeller (bir işlev dosyasını kaynakladıktan sonra, değişkenlerden birini fonksiyonunu ve ne demek istediğimi göreceksiniz).

Bu nedenle, içinde tüm işlevlerinizin bulunduğu .ps1 dosyasını MyFunctions.psm1 olarak yeniden adlandırın (yeni bir modül oluşturdunuz!). Şimdi bir modülün düzgün bir şekilde yüklenmesi için dosya ile ilgili bazı özel şeyler yapmanız gerekir. İçe Aktarma Modülü'nün modülü görmesi için (modülü kabuk içine yüklemek için bu cmdlet'i kullanırsınız), belirli bir konumda olması gerekir. Modüller klasörünün varsayılan yolu $ home \ Documents \ WindowsPowerShell \ Modules şeklindedir.

Bu klasörde, MyFunctions adlı bir klasör oluşturun ve MyFunctions.psm1 dosyasını bu klasöre yerleştirin (modül dosyası PSM1 dosyasıyla tam olarak aynı ada sahip bir klasörde bulunmalıdır).

Bu yapıldıktan sonra PowerShell'i açın ve şu komutu çalıştırın:

Get-Module -listavailable

MyFunctions adında bir tane görürseniz, bunu doğru yaptınız ve modülünüz yüklenmeye hazırdır (bu sadece bunun doğru şekilde ayarlandığından emin olmak içindir, bunu sadece bir kez yapmanız gerekir).

Modülü kullanmak için kabuğa aşağıdakileri yazın (veya bu satırı $ profilinize koyun veya bunu komut dosyasında ilk satır olarak yerleştirin):

Import-Module MyFunctions

Artık işlevlerinizi çalıştırabilirsiniz. Bununla ilgili güzel olan şey, orada 10-15 fonksiyona sahip olduğunuzda, bir çiftin adını unutacağınızdır. Bunları bir modülde varsa, modülünüzdeki tüm işlevlerin bir listesini almak için aşağıdaki komutu çalıştırabilirsiniz:

Get-Command -module MyFunctions

Oldukça tatlı ve ön tarafa kurmak için harcanan küçük çaba buna değer.

. "$PSScriptRoot\MyFunctions.ps1" MyA1Func

Availalbe v3'ten başlayarak bundan önce bkz . PowerShell betiğinin dosya sistemi konumunu nasıl alabilirim? . ÇOK yaygındır.

PS: 'Her şey bir modül' kuralına abone değilim. Betiklerim GIT dışındaki diğer geliştiriciler tarafından kullanılıyor, bu yüzden betiğimin çalışması için belirli bir yere malzeme koymak veya sistem ortamı değişkenlerini değiştirmek istemiyorum. Bu sadece bir senaryo (ya da iki ya da üç).

Komut dosyalarındaki işlevleri kesinlikle tanımlayabilirsiniz (daha sonra bunları yükümdeki Powershell profilimden yükleme eğilimindeyim).

İlk önce çalıştırarak işlevin yüklendiğinden emin olmanız gerekir:

ls function:\ | where { $_.Name -eq "A1"  }

Ve listede göründüğünü kontrol edin (1 listesi olmalı!), Sonra hangi çıktıyı aldığınızı bize bildirin!

Aşağıdakilere işlev ekleyebilirsiniz:

c:\Users\David\Documents\WindowsPowerShell\profile.ps1

Bir fonksiyon mevcut olacaktır.

Dosyanızda aramak / göstermek istediğiniz tek bir ana işlev varsa, dosyayı şu şekilde de başlatabilirsiniz:

Param($Param1)

Daha sonra örneğin şu şekilde arayabilirsiniz:

.\MyFunctions.ps1 -Param1 'value1'

Bu, fonksiyonu içe aktarmak zorunda kalmadan kolayca bu fonksiyonu çağırmak istiyorsanız çok daha kolay hale getirir.

İşlev-Dumb () adında bir yöntemi olan Dummy-Name.psm1 adlı bir modül dosyanız olduğunu varsayarsak

Import-Module "Dummy-Name.psm1";
Get-Command -Module "Function-Dumb";
#
#
Function-Dumb;