Набор средств для разработки ПО для SharePoint (SDK)

PowerShell поставляется с многочисленными командлетами. Более 500 из них предназначены для работы с SharePoint, и это количество возрастает с каждым новым выпуском или сервисным пакетом. Запомнить все эти команды непросто.

Среди всех командлетов имеются два вспомогательных, которые используются для справки; они помогают понять смысл отдельных командлетов. Введите в окне PowetShell команду

Get-Command

^— Администрирование и автоматизаций ^arcT^lM—! |

Глава 7

Эта команда выводит перечень всех команд, доступных в SharePoint. Из-за большого количества командлетов результат ее работы не умещается на экране. Чтобы вывести подмножество команд, которые относятся только к одной теме — например, к сайтам (site) — введите следующую команду:

Get-Command *Site*

Такая команда выводит список всех командлетов, в имени которых имеется строка “Site”. В зависимости от вашей версии SharePoint, вы получите результат, который более или менее похож на рис. 7.3.

Как видите, команды обычно начинаются с английского глагола (get — получить, set — установить, backup — создать копию и тд.), а заканчиваются существительным. Все команды, приведенные на рис. 7.3, позволяют работать с семействами сайтов SharePoint и либо выбирают их свойства (командлеты, начинающиеся на Get-), либо изменяют эти свойства (командлеты, начинающиеся на Set-).

Большинству команд SharePoint для их работы нужны входные данные. Если вызвать команду без необходимых параметров, то появится приглашение ввести их. Для освоения командлетов PowerShell введите команду

Get-Help Get-SPSite

Эта команда выводит подробную справку по командлету Get-SPSite. Ее можно ввести с дополнительным параметром -examples (примеры) или -detailed (подробно) и получить дополнительную информацию. Командлеты SharePoint хорошо документированы, и их можно использовать для первоначального изучения командлетов PowerShell.

i¹⁶² ‘ ---

Первый командлет SharePoint

Проще всего начать работать с командлетами SharePoint, запустив оболочку SharePoint 2010 Management Shell. На компьютере, где установлен SharePoint 2010, выберите пункт меню StartoAII Programs¹^ Microsoft SharePoint 2010 Productso SharePoint 2010 Management Shell (Пуск^Программы¹^Продукты Microsoft SharePoint 2010¹^Оболочка управления SharePoint 2010). После загрузки оболочки введите в окне командной строки следующую команду;

Get-SPSite

Она выводит список всех семейств сайтов в текущей ферме SharePoint. Пример выполнения такой команды приведен на рис. 7.4.

PS С: U,«i's^f4fi*a4*irrti y>G»c-Sjif ice

hi ipi/vport^l.norcl pfori.ron Iit1 [ -\1.c.o>4V4j yafcc.'on

PS C-MJ e«>cNflAvi*ict oi‘> _

Puc. 7.4. Вывод списка всех адресов семейства сайтов SharePoint с помощью командлета Get-SPSi te

Глаголы и существительные

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

Часто выполняются также операции изменения (Set-), удаления (Remove-) и создания (New-) объектов.

Большинство командлетов SharePoint выполняют одну из этих четырех операций. Однако для некоторых объектов существуют и другие командлеты, зависящие от вида объекта: например, объект SPSite сопровождается командлетами копирования (Backup-), перемещения (Move-) и восстановления (Restore-).

Работа с переменными, функциями и командлетами

Переменные PowerShell позволяют хранить результаты любой выполняемой команды. Вот пример использования переменных:

$SiteCollection = Get-SPSite "http://portal.companyabc.coin"

$SiteCollection.Url

$SiteCollection.Owner

Здесь первая команда сохраняет семейство сайтов (по адресу http: / /portal. corrpanyabc. com) в переменной $SiteCollection, а затем эта переменная используется для выборки

Администрирование и автоматизация sharet'oint...,

^{_ _} 163

Глава 7

свойств. В данном примере выбираются свойства Url и Owner, которые выводятся в окне оболочки.

Значение, которое сохранено в $SiteCollection, является объектом.NET Framework, относящимся к SharePoint (SPSite), и позволяет обращаться ко всем доступным свойств вам. как и в любом другом языке.NET.

Подробную информацию о SharePoint 2010 SDK можно прочитать на странице по

Адресу

http://msdn.microsoft.com/en-us/library/ee557253(office.14).aspx

Конвейер команд PowerShell

В реальной жизни конвейеры используются для перемещения предметов из одного места в другое. Конвейеры PowerShell работают аналогично: они позволяют легко преобразовывать, изменять или передавать результат одного командлета другому.

Допустим, нам нужно вывести список всех семейств сайтов в ферме SharePoint. Этот список формируется командлетом Get-SPSite, но в больших фермах такой список может содержать сотни и тысячи строк. А если командлет Get-SPSite использовать вместе с командой фильтра (с помощью конвейера), то он возвратит только нужные семейства сайтов:

Get-SPSite I Where {$_.Url -eq "http://portal.conpanyabc.com"}

Символ конвейера “ I ” передает результаты (все семейства сайтов) командлета Get-SPSite фильтру Where, который указывает, что следующему командлету в конвейере необходимо передать только те семейства сайтов, URL которых равен

http://portal.companyabc.com

В предыдущем примере задействован только один конвейер, но их может быть и несколько:

Get-SPSite I Where {$_.Url -like "*portal*"} I Sort RootWeb I Select RootWeb, Url

Данная команда выводит все семейства сайтов, которые содержат в своем URL-адресе строку “portal”, сортирует их по значениям свойства RootWeb и выводит результаты в табличном виде с двумя столбцами RootWeb и Url.

На рис. 7.5 показан результат выполнения последней команды в окне SharePoint 2010 Management Shell.

'PS C.4U.*' 4flili_inistrntoi^>> Uet-SPSitc I Wbere f$_.U*l -lihe ""port» ootlfeb! Select V «с11ц^>>. Url

lit ip://poi-t«l.coni><4«yd|kc.'-on he l l>://рор!* 1. no rt tiuibri. coo

l-tjl Cv*N|>AftyflBC LPor*c,il tiorthlfinri

Рис. 7.5. Список семейств сайтов со словом portal в URL-adpecax, выведенный PowerShell

Форматирование результатов

Результаты, полученные командлетами PowerShell, обычно выводятся в табличной форме, но их можно дополнительно оформить с помощью команды форматирования. Обычно это команды Format-List, Format-Table и Format-Wide.

Get-SPSite | Select RootWeb, Url, Owner I Format-Table

Данная команда выводит все семейства сайтов в виде таблицы, в которой отображаются свойства семейств сайтов RootWeb, Url и Owner.

Кроме форматирования результатов, можно выбрать место выдачи результатов, отличное от стандартного (экран оболочки). Одним из таких полезных мест является GridView:

Get-SPSolution | Select * I Out-GridView

Эта команда выводит все установленные решения SharePoint в формате GridView (рис. 7.6). При отсутствии установленных решений можно объединять командлет Out-GridView с другими командами — например, с Get-SPSite.

PowerShell — новая STSADM

С выпуском SharePoint 2010 язык PowerShell стал наиболее важным средством автоматизации администрирования SharePoint. Каждая операция администрирования вначале поставляется для PowerShell, а некоторые операции (например, дополнительная настройка во время инсталляции, администрирование нескольких арендаторов и т.д.) доступны только через PowerShell. Встроенные командлеты имеют гораздо больше возможностей, чем пользовательский интерфейс центра администрирования и команды STSADM.

Администраторы все равно могут пользоваться всеми тремя интерфейсами: администратор, которому лишь изредка нужно создать отдельное семейство сайтов, вполне обойдет-