Рекомендации по разработке командлетов Powershell
В настоящее время я собираю несколько командлетов Powershell. Создать их достаточно легко, но я не знаю, приемлемым ли я (так сказать) ли я создаю их.
Существуют ли какие-либо рекомендации / передовые методы, которым следует следовать для передачи данных в конвейер Powershell? На данный момент я фактически вывожу один объект типа DataSet - если какой-либо командлет захочет использовать его в нисходящем потоке, им придется перебирать DataTables в этом DataSet, а затем перебирать DataRows в каждом DataTable.
Думаю, вопрос в том ... Собираюсь ли я кого-нибудь разозлить этим? Или я должен выводить данные, которые по своей сути представляют собой набор строк?
Заранее всем спасибо
-JT
Ответы 2
Допустимо выводить любой тип объекта, который лучше всего подходит для представления того, что вы пишете - DataSet абсолютно нормально. Единственное возможное предостережение заключается в том, что версия 2 PowerShell может работать в сокращенной версии .NET Framework (например, в Server Core), поэтому, если это потенциальный сценарий для ваших командлетов, вам нужно проявлять осторожность, чтобы убедиться, что объект, который вы выводите, существует в каждой системе, где может использоваться ваш командлет.
При этом конвейер работает лучше всего, когда он содержит коллекции объектов; DataSet не является коллекцией как таковой. Другими словами, вы хотите, чтобы нижестоящие командлеты могли получать по одному объекту за раз через конвейер, чтобы этим командлетам не приходилось вручную перечислять через объект. Я не очень разбираюсь в том, что именно вы делаете - вполне возможно, что DataSet вполне подходит, - но я обычно предпочитаю видеть цикл командлета через DataSet внутри, создавая свои собственные настраиваемые объекты (чтобы каждый столбец в таблице становится свойством) и выводит эти объекты в конвейер. Это просто увеличивает количество подчиненных командлетов, которые могут потреблять то, что вы публикуете.
Простой тест - передать выходные данные вашего командлета в Export-CSV. Если это работает (а с DataSet, вероятно, не будет), значит, вы делаете правильный выбор в целом. Теперь вам может потребоваться создать командлет, который выводит DataSet, и вы только намереваться для некоторых других командлетов, которые вы написали (которые используют DataSets), чтобы работать с этим выходом. В этом нет ничего плохого. Однако максимальная гибкость - это отдельные объекты, поскольку она позволяет всем основным командлетам PowerShell работать с вашим выводом.
Надеюсь, это поможет.
В MSDN есть замечательный набор Рекомендации по разработке командлетов, который я нашел чрезвычайно полезным при разработке своего собственного. Они разбиты на три разных раздела:
- Необходимые правила разработки
- Настоятельно рекомендуется руководство по развитию
- Рекомендации по развитию
Все ссылки сейчас не работают