Введение в командлеты оболочки управления SharePoint

Статья
04/21/2015

Дата последнего изменения: 14 января 2010 г.

Применимо к: SharePoint Foundation 2010

Windows PowerShell™ — это новое средство командной строки и язык скриптов от корпорации Майкрософт, которые дополняют программу Cmd.exe в контексте администрирования Windows и заменяют средство администрирования Stsadm.exe. Хотя и Cmd.exe, и Stsadm.exe поддерживаются для обратной совместимости, все текущие и будущие разработки скриптов и административных файлов в SharePoint Foundation должны использовать эту технологию скриптов.

Основы Windows PowerShell

В отличие от большинства других средств командной строки, которые принимают и возвращают текстовые данные, Windows PowerShell основано на платформе Microsoft .NET Framework и поэтому принимает и возвращает объекты .NET Framework. Это фундаментальное отличие позволяет создавать новые методы и средства для улучшения управления, эффективности и производительности разработчиков и администраторов.

Windows PowerShell — это простое средство командной строки, в котором вводится понятие командлета. Командлет — это сочетание глагола и существительного, представляющих команду и объект, к которому она применяется. Имена командлетов Windows PowerShell состоят из глаголов и существительных, разделенных дефисом (-), которые определяют функциональные свойства командлета. Например, имя командлета Get-SPSite содержит глагол (команду) "Get" и существительное (объект) "SPSite" для обозначения командлета, который получает указанный объект SPSite. Командлеты можно использовать отдельно или объединять их в связанные последовательности для выполнения сложных задач.

Существительные командлетов принимают параметры в виде пар имени и значения, которые определяют существительное командлета. При вызове командлетов они возвращают выходные объекты. Эти объекты также содержат свойства, которые отображаются в виде пар имени и значения. Так как командлеты возвращают объекты, их можно передавать (или "ставить в конвейер") другим командлетам в последовательности. Таким образом командлеты можно объединять, что дает невероятную гибкость при их использовании.

К слову, это только одно из отличий командлетов Windows PowerShell и команд stsadm.exe. Например, следует запомнить, что командлет — это не исполняемый файл, а, скорее, экземпляр класса .NET Framework. Поэтому, с некоторыми исключениями, командлеты возвращают объекты, а не текстовые потоки, и они обрабатывают входные объекты из конвейера.

Как видно, Windows PowerShell — это не просто новое средство командной строки. Также, что более важно, это новый язык скриптов. Windows PowerShell устанавливает более 100 базовых командлетов Windows. Библиотека командлетов SharePoint Foundation, которая на данный момент содержит более 500 командлетов, устанавливается в дополнение к основным командлетам Windows. Доступ к командлетам SharePoint предоставляется с помощью специальной оболочки командной консоли SharePoint.

Командлеты оболочки управления SharePoint

Windows PowerShell предоставляют общую реализацию и реализацию для SharePoint. В общем отличие заключается в том, что командлеты Windows PowerShell образованы от базового класса PSCmdlet, а командлеты SharePoint Foundation образованы от специализированного базового класса SharePoint с именем SPCmdlet.

Важно!
Различие командлетов Windows PowerShell, производных от класса PSCmdlet, и командлетов SharePoint, производных от класса SPCmdlet, очень существенно. Все командлеты SharePoint, которые поставляются с SharePoint Foundation и доступны в командной консоли SharePoint, производные от класса SPCmdlet. Кроме того все пользовательские командлеты для поддержки развертываний SharePoint также должны быть командлетами SharePoint.

Различие командлетов Windows PowerShell, производных от класса PSCmdlet, и командлетов SharePoint, производных от класса SPCmdlet, очень существенно. Все командлеты SharePoint, которые поставляются с SharePoint Foundation и доступны в командной консоли SharePoint, производные от класса SPCmdlet. Кроме того все пользовательские командлеты для поддержки развертываний SharePoint также должны быть командлетами SharePoint.

Далее представлена сигнатура базового класса SPCmdlet. Учтите, что SPCmdlet — класс, производный от класса PSCmdlet.

public abstract class SPCmdlet : PSCmdlet

Обратите внимание, что при использовании командлетов с переменными операторами, такими как Get, Set, New и Remove, следует применять определенные реализации класса SPCmdlet, а не производные от класса PSCmdlet. Это верно для модели скриптов для использования командлетов Windows PowerShell в SharePoint Foundation.

Для командлетов, обрабатывающих постоянные объекты: