Як в PowerShell визначити функцію у файлі та викликати її з командної лінії PowerShell?

У мене є .ps1 файл, в якому я хочу визначити власні функції.

Уявіть, що файл називається MyFunctions.ps1, а вміст такий:

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

Щоб запустити цей скрипт і теоретично зареєструвати функцію A1, я переходжу до папки, в якій знаходиться файл .ps1, і запускаю файл:

.\MyFunctions.ps1

Це виводи:

Installing functions
Done

Тим не менш, коли я намагаюся зателефонувати на A1, я просто отримую помилку, вказуючи, що немає команди та функції під цим ім'ям:

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

Я повинен неправильно зрозуміти деякі концепції PowerShell. Чи не можу я визначити функції у файлах сценаріїв?

Зауважте, що я вже встановив свою політику виконання на "RemoteSigned". І я знаю запускати .ps1 файли, використовуючи крапку перед іменем файлу:. \ MyFile.ps1

Спробуйте це в командному рядку PowerShell:

. .\MyFunctions.ps1
A1

Оператор крапки використовується для сценарію include.

Те, про що ви говорите, називається крапковим джерелом . І це зло. Але не хвилюйтесь, є кращий і простіший спосіб зробити те, що ви хочете, з модулями (це звучить набагато страшніше, ніж це). Основна перевага використання модулів полягає в тому, що ви можете вивантажити їх з оболонки, якщо вам потрібно, і це утримує змінні у функціях з повзання в оболонку (як тільки ви отримаєте точку джерела файлу функції, спробуйте викликати одну із змінних з функціонувати в оболонці, і ви побачите, що я маю на увазі).

Отже, спочатку перейменуйте файл .ps1, у якому є всі ваші функції, в MyFunctions.psm1 (ви тільки що створили модуль!). Тепер, щоб модуль належним чином завантажився, потрібно зробити деякі файли з файлом. Спочатку Import-Module побачив модуль (цей командлет ви використовуєте для завантаження модуля в оболонку), він повинен знаходитися в певному місці. Шлях до папки з модулями за замовчуванням - $ home \ Documents \ WindowsPowerShell \ Modules.

У цій папці створіть папку з назвою MyFunctions і помістіть у неї файл MyFunctions.psm1 (файл модуля повинен містити папку з точно такою ж назвою, що і файл PSM1).

Після цього відкрийте PowerShell і запустіть цю команду:

Get-Module -listavailable

Якщо ви бачите один під назвою MyFunctions, ви зробили це правильно, і ваш модуль готовий до завантаження (це просто для того, щоб це було налаштовано правильно, робити це потрібно лише один раз).

Щоб використовувати модуль, введіть у оболонці наступне (або введіть цей рядок у свій профіль $ або поставте це як перший рядок у сценарії):

Import-Module MyFunctions

Тепер ви можете запускати свої функції. Прикольна річ у тому, що як тільки у вас буде 10-15 функцій, ви забудете ім'я пари. Якщо у вас є модуль, ви можете запустити наступну команду, щоб отримати список усіх функцій вашого модуля:

Get-Command -module MyFunctions

Це досить солодко, і крихітний шматочок зусиль, який він потребує, щоб встановити на передній стороні, НАДІЙНО варто.

. "$PSScriptRoot\MyFunctions.ps1" MyA1Func

Availalbe, починаючи з v3, перед цим див. Як я можу отримати розташування файлової системи сценарію PowerShell? . Це ДУЖЕ звичайно.

PS Я не підписуюся на правило "все - це модуль". Мої сценарії використовуються іншими розробниками з GIT, тому мені не подобається розміщувати матеріали в певному місці або змінювати змінні системного середовища до того, як мій сценарій запуститься. Це просто сценарій (або два, або три).

Ви, звичайно, можете визначати функції у файлах сценаріїв (я тоді схильний завантажувати їх через мій профіль Powershell при завантаженні).

Спочатку потрібно перевірити, щоб переконатися, що функція завантажена запуск:

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

І переконайтеся, що воно відображається у списку (має бути список 1!), То повідомте нам, який результат ви отримаєте!

Ви можете додати функцію до:

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

Функція буде доступна.

Якщо у вашому файлі є лише одна основна функція, яку ви хочете зателефонувати / відкрити, ви також можете просто запустити файл із:

Param($Param1)

Потім ви можете назвати це, наприклад, наступним чином:

.\MyFunctions.ps1 -Param1 'value1'

Це робить набагато зручнішим, якщо ви хочете легко зателефонувати саме до цієї функції, не потребуючи імпорту функції.

Припустимо, у вас є файл модуля під назвою Dummy-Name.psm1, який має метод під назвою Function-Dumb ()

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