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

Question

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

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

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

Это запрос-p4sync? Или это "sync-p4 -whatif"? Или что-то другое?

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

Answer 1

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

Answer 2

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

Answer 3

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

Расширенные функции предоставляют возможность приписать вашу функцию, чтобы обеспечить встроенную поддержку -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
  }

}