Каковы хорошие рекомендации для именования глаголов PowerShell?

Question

Я только начинаю изучать PowerShell, и мне интересно, есть ли хорошие инструкции по использованию глаголов в Posh для командлетов (или расширенных функций, как они называются в CTP3).

Если я получу глагол, я смогу увидеть их много. Но я все еще не уверен, как мне выложить свои модули.

Вот пример, с которым я сейчас сталкиваюсь. У меня есть небольшой скрипт, который спрашивает Perforce: если бы я синхронизировал, какие файлы изменились бы и насколько они велики? Он выводит сводную информацию о размерах и мини-дереве папок, в которых будут отображаться изменения (а также сколько их потребуется разрешить).

Это запрос-p4sync? Или это «sync-p4 -whatif»? Или что-то еще?

Прежде чем я начну писать множество этих сценариев, я хочу убедиться, что я назвал их правильно.

Answer 1

Вы можете найти список общих глаголов на MSDN вместе с описанием, для чего они должны использоваться.

Answer 2

Вот обновленный список утвержденных глаголов в блоге Windows PowerShell от 15 июля.

Answer 3

Из-за использования вами слова «модули», я собираюсь догадаться, что вы используете PowerShell V2, который позволяет вам использовать Расширенные функции .

Расширенные функции предоставляют возможность приписать вашу функцию, чтобы обеспечить встроенную поддержку -WhatIf и -Confirm

function Sync-PerforceRepository()
{
  [cmdletbinding(SupportShouldProcess=$true)]
  param (...) #add your parameters
  Begin
  {
    #setup code here
  }
  Process
  {
    if ($pscmdlet.ShouldProcess($ObjectBeingProcessed,"String Describing Action Happening")
    {
      #Process logic here
    }
  }
  End
  {
     #Cleanup code
  }

}