Тем не менее, при необходимости эту форму можно отключить. Все, что требуется – выполнить команду PowerShell.

Итак, по порядку.

1. Для целей тестирования создадим тестовый ящик testtime@studentmail.info .

New-Mailbox –Name testtime –DisplayName TestTime –WindowsLiveID testtime@studentmail.info –Password (ConvertTo-SecureString –AsPlainText ‘Password’ –Force)

2. Установим региональную конфигурацию. Очень важный параметр – TimeZone, определяющий время учетной записи. От него зависит корректность отображения встреч календаря. Если часовой пояс будет выбран неправильно, пользователи из разных регионов получат неактуальное время общих собраний. Вот именно поэтому я рекомендую оставлять форму выбора часового пояса, чтобы студенты могли определиться с часовым поясом наиболее корректным образом.

Set-MailboxRegionalConfiguration 'testtime@studentmail.info' -Language ru-RU -TimeZone "Russian Standard Time"

• Список доступных часовых поясов можно найти здесь: https://msdn.microsoft.com/en-us/library/ms912053(WinEmbedded.10).aspx .
• Список доступных языков: https://msdn.microsoft.com/en-us/library/ms533052(VS.85).aspx (LCID codes)

3. Для того, чтобы убедиться в том, что календарь будет отображать правильный день начала недели, есть смысл выполнить команду назначения первого дня недели.

Set-MailboxCalendarConfiguration 'testtime@studentmail.info' -WeekStartDay Monday

Вы еще не используете PowerShell для управления организацией? Начните прямо сейчас - https://help.outlook.com/ru-RU/140/cc546278.aspx .

1. Exchange Web Services (EWS) – для управления сервером Exchange: работа с письмами, календарем, контактами и др. объектами Exchange.
2. Single Sign-On (SSO) – единый вход в Live@edu
3. Windows PowerShell 2 (PS) – основная технология для управления Exchange Server и другими продуктами Microsoft. В Live@edu также отвечает за управление учетными записями.
4. Windows Live Admin Center (WLAC - ManageDomain2 web-service) – служит для управления учетными записями Windows Live ID. Эта технология не поддерживается для Live@edu, поэтому крайне не рекомендуется использовать команды этого модуля.

Для каждой из перечисленных технологий существует свой набор SDK:

• EWS - специальный Managed API,
• Single Sign-On – демонстрационный портал и целый ряд специальных классов (до недавнего времени в SSO toolkit входил также и сервер Windows Live ID),
• PS - требуется подключение специального класса (который пока официально не существует), а также отслеживание конвейера и открытых удаленных сессий;
• WLAC – предоставляет очень ограниченные возможности управления, однако базовые операции, такие, как сброс пароля, удобнее делать через него.

Кроме этого я реализовал 3 из 4 технологий (за исключением PS) в PHP, что позволяет интегрировать сервисы и с этой платформой.

При серьезном подходе на освоение всех 4 перечисленных блоков потребуется не более одной недели, при этом интеграция может быть довольно тесной – от авторизации на портале с помощью Windows Live ID до полноценных веб-частей электронной почты и календаря, а также интеграции с системой расписания.

В то же время, основная проблема с которой мы столкнулись при помощи во внедрении – это понимание разовой природы процесса (действительно, интеграцию достаточно один раз установить и забыть про необходимость поддержки), в связи с чем выделение на глубокое изучение Microsoft Live@edu недели времени невозможно.

Мы пошли навстречу и разработали уникальный продукт, являющийся к тому же бесплатным и с открытым кодом, – Live at Education Meta Web-Service. Основная задача этого веб-сервиса – предоставление разработчику единого интерфейса управления всем входящими в Live@edu технологиями. При этом в ближайшей версии мы внедрим поддержку единого входа в систему MSDN AA ELMS, о чем будет дополнительная запись блога.

Чтобы не быть голословным, приведу несколько примеров на языках .NET и PHP.

Оцените, как просто изменить первичный адрес электронной почты (например, если вуз генерирует ящик 123739457934859823@vuz.ru по уникальному коду-хэшу, предоставляя студенту право выбрать используемое имя, например vasya@vuz.ru, самостоятельно):

ws.PS_Execute("%{Invoke-Command -Session $rs {Set-Mailbox 123739457934859823@vuz.ru -EmailAddresses vasya@vuz.ru}}");

И все – никаких дополнительных библиотек, подключаемых к программному коду вашего продукта, никаких лишних модулей. Одна задача – один вызов метода веб-сервиса.

При этом на стороне веб-сервиса организовано автоматическое создание необходимых подключений при первом вызове соответствующего метода, а также кэширование подключения удаленной сессии PowerShell (этот процесс занимает 10-15 секунд и его вызов каждый раз для, например, изменения первичного SMTP-адреса был бы очень длительным), соединения EWS и т.д. для максимального повышения эффективности.

Веб-сервис можно размещать как непосредственно на сервере с порталом, так и на каком-либо централизованном узле, делая его доступным для нескольких проектов. При этом доступ к различным Live@edu/MSDN AA подпискам разграничен для разных пользователей.

Более подробно основные рекомендации по интеграции, а также подробности по работе с веб-сервисом, включая ссылки на загрузку и документацию, изложены здесь:

Несмотря на то, что веб-сервис фактически стал доступен всего 1-2 недели назад, мы уже подключили его для нескольких проектов с общим количеством пользователей более 100 тысяч. При этом время загрузки интегрированных модулей Live@edu (ссылки на сервисы, индикация непрочтенной почты, возможность сброса пароля) сократилась в 3-4 раза от 5-6 секунд до 1-2.

В настоящий момент мы ведем разработку мета-сервиса, который позволит применять стандартные методы веб-сервисов для управления всеми компонентами Live@edu, однако для того, чтобы понимать, как работает веб-сервис, создавая пользователей, группы и выполняя настройки, предлагаю убедиться, что доступ к PowerShell из C# действительно очень удобен и прост.

1. Добавление ссылки на сборку

Необходимо добавить ссылку на сброку System.Management.Automation. Она располагается в каталоге C:\Program Files\Reference Assemblies\Microsoft\WindowsPowerShell\v1.0.

2. Подключение типов

Добавьте ссылки на типы в код C#.

using System.Collections.ObjectModel;
using System.Management.Automation;
using System.Management.Automation.Runspaces;

3. Метод запуска команды (сценария)

Добавьте функцию, который будет выполнять команду PowerShell и возвращать результат в виде строки.

static string RunScript(string scriptText)
        {
            Runspace runspace = RunspaceFactory.CreateRunspace(); // создание процесса

            runspace.Open(); // открытие процесса

            Pipeline pipeline = runspace.CreatePipeline(); // создание конвейера

            pipeline.Commands.AddScript(scriptText); //добавление сценария

            pipeline.Commands.Add("Out-String"); // эта команда форматирует вывод. Без нее возвращаются реальные объекты.

            Collection<PSObject> results = pipeline.Invoke(); // запуск сценария

            runspace.Close(); // закрыте процесса

            StringBuilder stringBuilder = new StringBuilder(); // конвертация результата в одну строку с использованием StringBuilder;
            foreach (PSObject obj in results)
            {
                stringBuilder.AppendLine(obj.ToString());
            }

            return stringBuilder.ToString(); // возврат значения
        }

4. Использование

Выполните команду Get-Process и посмотрите результат.

string result = RunScript("Get-Process");
Console.WriteLine(result);
Console.ReadLine();

Ссылки:

• Исходный сценарий был опубликован в блоге https://www.codeproject.com/KB/cs/HowToRunPowerShell.aspx?df=100&forumid=402039&exp=0&select=2164398 .
• Возможность асинхронного запуска также рассматривается в статье автора https://www.codeproject.com/KB/threads/AsyncPowerShell.aspx .
• PowerShell в WikiPedia - https://ru.wikipedia.org/wiki/Windows_PowerShell .

Чтобы облегчить внедрение я собрал все 3 технологии воедино. Есть всего несколько шагов, которые нужно выполнить для того, чтобы обогатить Ваш PHP-портал функциями управления Microsoft Live@edu .

1. Получение сертификата

Для получения сертификата посетите страницу https://eduadmin.live.com/SSO.aspx , авторизовавшись с помощью идентификатора Windows Live ID администратора домена, и нажмите кнопку “Запросить поддержку единого входа”.

В течение примерно недели Вы получите последовательно три письма. В первом будет ссылка на загрузку сертификата, во втором – пароль для загрузки и в третьем – идентификатор SiteID, шестизначный код для настройки модуля единого входа (SSO).

2. Загрузка класса

Загрузите комплект PHP SSO в папке SkyDrive.

3. Подготовка сертификата

В комплекте, полученном от ed-desk (п. 1), Вы найдете два файла: .cer и .pfx. Для работы системы SSO Вам потребуется сконвертировать сертификат из файла .pfx. Сделать это можно с помощью утилиты openssl.exe, входящей в состав дистрибутива:

1. Командный файл runme.bat выполняет все необходимые команды при передаче ему параметром Вашего файла с сертификатом.
2. При запросе пароля нажмите Enter.
3. На выходе получится файл all.cer .
4. Полученный файл необходимо разделить на две части.
5. В первый файл с именем private.pem поместите первую часть файла до “-----END RSA PRIVATE KEY-----“ (включая эту строку).
6. Оставшуюся часть файла поместите в cer.pem .

4. Настройка модуля

Настройка модуля производится в файле settings.php:

• $adminwlid , $adminpass – имя и пароль администратора домена. Эти данные требуются для работы класса Windows Live Admin Center.
• $applicationid, $secretkey – идентификатор приложения, который можно получить по инструкции https://msdn.microsoft.com/en-us/library/bb676626.aspx. Скорее всего имя домена будет занято в связи с настройкой SSO, поэтому Вы можете зарегистрировать домен с www. Например, для домена @live.vuz.ru это будет www.live.vuz.ru . Эти данные требуются для работы Exchange Web Services.
• $ewsadmin, $ewspass – данные пользователя, наделенного правами имперсонации. Более подробно в пункте 1 https://mamichev.spaces.live.com/blog/cns!DAD805F3381EED7B!2753.entry .
• $siteid – идентификатор SiteID (п. 1)
• $cer, $private – файлы с сертификатом из пункта 4.

5. Использование функций в Вашем приложении.

В состав sso_class.php входят три класса – WLAC, SSO, EWS. Вы можете воспользоваться файлом index.php для того, чтобы посмотреть пример использования всех реализованных возможностей.

Подключите файл класса и настроек:

include("settings.php");
include("sso_class.php");

Windows Live Admin Center (WLAC)

Вы можете создавать и удалять пользователей, менять пароль, адрес электронной почты и другие возможности, перечисленные на странице описания веб-сервиса https://domains.live.com/service/managedomain2.asmx . Обратите внимание, что функции расширенного управления недоступны для учетной записи Live@edu .

Для инициализации выполните команду:

• $wl = new wlac($adminwlid,$adminpass);

Теперь Вы можете выполнять команды, которые реализованы в файле index.php, например:

• $wl->Execute("ResetMemberPassword",Array("memberNameIn"=>$_POST['email'],"password"=>$_POST['password'],"resetPassword"=>"false"));

Метод Execute принимает два параметра. Первый – команда, второй – массив с параметрами. Если необходимо передавать многострочные параметры, можно использовать вложенный массив.

К адресу электронной почты и паролю, допустимому в Windows Live, есть определенные требования. Проверить правильность пароля можно с помощью метода:

• $wl->validate_creds($email,$pass)

На выходе будет массив с ошибками.

Single Sign-On (SSO)

Этот класс позволяет предоставить пользователю возможность доступа к сервисам Live@edu (Outlook Live, Office Live, Windows Live) после авторизации на Вашем портале без дополнительной авторизации Windows Live. SSO необходимо запросить и как это сделать, описано выше.

Процесс SSO состоит из трех шагов:

1. Получение Short Living Ticket (SLT) – кода авторизации для любого пользователя:

$getSLT = new GetSLT($siteid,$cer,$private);

2. Получение ссылки для переадресации (класс поддерживает сервисы outlooklive, olw, skydrive, spaces, home):

$ssourl = $getSLT->ServiceUrl($_POST['service'])."&slt=".$getSLT->Request($_POST['email'],"30");

3. Переадресация

header("location:$ssourl"); die();

Exchange Web Services (EWS)

Учебные заведения, подписанные на услугу Live@edu Organization (организации, зарегистрированные до 5 августа 2009-го года и подписавшие новое соглашение, и все организации, зарегистрированные после 5 августа 2009-го года) могут использовать технологию Exchange Web Services для получения доступа к данным пользователя для отображения их на портале после авторизации.

Пользователь (не обязательно администратор), который используется для обращения к серверу, должен обладать правами имперсонации. Как предоставить такие права, написано в пункте 1 инструкции https://mamichev.spaces.live.com/blog/cns!DAD805F3381EED7B!2753.entry .

Для инициализации функции выполните:

• $lews = new LAE_EWS(Array("admin"=>$ewsadmin,"pass"=>$ewspass,"appid"=>$applicationid,"seckey"=>$secretkey));

Для использования EWS обращайтесь к методам класса, например, для просмотра писем:

• $emails = $lews->GetEMails($_POST['email'],10,0);

Вы можете найти множество дополнительных функций, доступных для использования с EWS, в прототипе https://www.educationlabs.com/projects/moodleproduct/Pages/default.aspx .

6. Ссылки

Код в приложении уникален, однако основные принципы управления сервисами были “подсмотрены” в базовых разработках:

• Single Sign-On – концепция разработана Адамом Брэдли (Adam Bradley) в проекте https://phplivesso.codeplex.com/
• Exchange Web Services – технология управления EWS проработана в решении Microsoft Education Labs https://www.educationlabs.com/projects/moodleproduct/Pages/default.aspx .
• Windows Live Admin Center – структура подсмотрена у Mauricio Cuenca по адресу https://www.mauriciocuenca.com/blog/2008/07/windows-live-admin-center-php-client/ . Интересную реализацию также можно найти здесь: https://social.msdn.microsoft.com/forums/en-US/wlgeneraldev/thread/0720ba9e-85b8-4689-a2b6-20acf3d727fa/ , однако у меня возникли трудности с установкой и использованием библиотеки SOAP, поэтому я предпочел сделать несколько простых методов на базе CURL.

• Есть ли ограничения на размер сообщений?
• Сколько получателей может быть у одного письма?
• Есть ли ограничения на общий размер почтового ящика?

Ответы на эти вопросы Вы можете найти в разделе помощи системы Outlook Live: https://help.outlook.com/ru-ru/140/dd630704(en-us).aspx

https://msdn.microsoft.com/en-us/library/dd877012(EXCHG.140).aspx

Загрузка Microsoft Exchange Web Services Managed API 1.0 beta доступна по адресу https://msdn.microsoft.com/en-us/library/dd633710.aspx , прямая ссылка на загрузку: https://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=e8f38dd1-f123-4a16-b4c8-584d1f84af48 .

Статья про имперсонацию https://blogs.msdn.com/exchangedev/archive/2009/06/15/exchange-impersonation-vs-delegate-access.aspx .

Настройка ролей в Live@edu: https://help.outlook.com/ru-ru/140/dd207272.aspx?ref=search .

Делегирование права имперсонации:

New-ManagementRoleAssignment -Name <name for the management role assignment> -Role  ApplicationImpersonation  -User <existing Windows Live ID>

Как отправить письмо: https://www.codeproject.com/KB/exchange/Exchange2007EWS-Part1.aspx 

Пример использования и комментарии – в блоге команды MS Exchange по адресу https://msexchangeteam.com/archive/2009/04/21/451126.aspx .

Описание сервисов в группе https://liveatedu.groups.live.com - https://liveatedu.spaces.live.com/blog/cns!C76EAE4D4A509FBD!1118.entry и https://liveatedu.groups.live.com/discussions/discussion.aspx?id=cns!977D36638ABBB!333 .

Информация о возможности не использовать функцию autodiscover: https://outlookliveanswers.com/forums/t/321.aspx .

Запись Live-meeting по использованию EWS с примером программирования: https://connect.microsoft.com/Downloads/DownloadDetails.aspx?SiteID=452&DownloadID=17705 .

Для того, чтобы обеспечить такую возможность, Вам необходимо:

1. Настроить возможность имперсонации для идентификатора администратора. 

New-ManagementRoleAssignment -Name EWSadmin -Role ApplicationImpersonation -User ewsadmin@example.com

Подробнее: https://help.outlook.com/ru-ru/140/dd207272.aspx?ref=search

2. Загрузить Exchange Web Services Application Program Interface (EWS API) и установить на сервер с порталом

https://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=e8f38dd1-f123-4a16-b4c8-584d1f84af48

3. Сослаться в коде на библиотеку

using Microsoft.Exchange.WebServices.Data;

4. Создать код имперсонации (можно выделить в отдельный метод или функцию):

string ewsAdmin = “ewsadmin@example.com”; // пользователь с правами имперсонации

string ewsPassword = “Pa$$w0rd”; // пароль пользователя

string  memberNameIn = “user@example.com”; // пользователь, для которого нужно получить/изменить информацию

            ExchangeService service = new ExchangeService(ExchangeVersion.Exchange2010);

            service.Credentials = new WebCredentials(ewsAdmin, ewsPassword);

            service.ImpersonatedUserId = new ImpersonatedUserId(ConnectingIdType.SmtpAddress, memberNameIn);

            service.Url = new Uri("https://pod51002.outlook.com/ews/exchange.asmx");

service.PreAuthenticate = true;

5. Добавить код для выполнения функций, например:

Создание события в календаре:

Appointment appointment = new Appointment(service);

appointment.Subject = “Демонстрационное событие”;

appointment.Body = new MessageBody();

appointment.Body.Text = “Текст события”;

appointment.Body.BodyType = (BodyType)Enum.Parse(typeof(BodyType), “text”);

appointment.Location = “Офис 210”;          

appointment.Start = “2009-09-30T12:30:00”;

appointment.End = “2009-09-30T15:30:00”;

appointment.Save();

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Отображение прочитанных / непрочитанных сообщений:

Folder inbox = Folder.Bind(service, WellKnownFolderName.Inbox); // Подключение к папке “Входящие”

Response.Write("Всего писем: " + inbox.TotalCount + ". Непрочтенных: " + inbox.UnreadCount); // Вывод сообщений

 

 

 

Вот и все! Студенты постоянно в курсе последних событий и наличия непрочтенных сообщений в своем ящике!

Дополнительная информация про EWS API: https://mamichev.spaces.live.com/blog/cns!DAD805F3381EED7B!2389.entry .

Форма регистрации, которая до внесенных изменений требовала введения достаточно объемной информации, также преобразилась и позволяет включиться в программу еще быстрее и удобнее.

1. Начало регистрации
   1. Для регистрации перейдите по ссылке https://get.liveatedu.com . При установке курсора в заполняемое поле Вам будет показана всплывающая подсказка, которая достаточно подробно объясняет назначение заполняемого поля. В том случае, если подсказки Вам недоступны, Вы можете воспользоваться нижеприведенным текстом.
   2. Нажмите кнопку “Зарегистрируйте свое учебное заведение”. Внимание! Вам необходимо осуществить выход из Windows Live, если Вы авторизованы по какой-либо учетной записи Windows Live ID.
   3. Выберите “Все готово для регистрации” или “Ознакомление” в зависимости от Вашей готовности к развертыванию.

Шаг 1 из 2. Указание своего учреждения и домена

1. Введите название Вашего учебного заведения (желательно на английском языке для более точной идентификации модераторами).
2. Выберите тип учебного заведения. Эти сведения помогают  понять, какие учебные заведения регистрируются для использования служб. Это никоим образом не влияет на доступные варианты служб.
3. Введите URL-адрес веб-сайта своего учебного заведения. Он может не совпадать с доменом, который будет использоваться для студенческой почты.
4. Выберите страну из выпадающего списка. Если страны в списке нет, значит программа Live@edu недоступна.
5. Введите название города (крайне рекомендуем вводить название города в соответствии с его официальным названием, например Санкт-Петербург, Ростов-на-Дону, поскольку это упростит группировку и поддержку Вашего участия в программе).
6. Выберите регион из выпадающего списка (города федерального значения Москва и Санкт-Петербург имеют отдельные строчки в списке, упорядоченном по алфавиту).
7. Введите имя домена для почты студентов. Домен определяется адресом электронной почты студентов, который нужно настроить. Например, после регистрации домена studentmail.info можно создать учетную запись пользователя ivan@studentmail.info.
8. В разделе “Почтовая служба” поле для ввода отсутствует, поскольку рекомендуемым вариантом почтовой службы является “Outlook Live”. Если Вы все же хотите использовать службу Hotmail для Ваших студентов, нажмите на ссылку “Дополнительные возможности” и выберите пункт “Hotmail”.
9. Нажмите кнопку “Далее”.

• Импорт любого типа файлов, который поддерживается MS Access (XLS, CSV и т.д.), включая подключение к базе данных SQL или списку Microsoft Office Sharepoint Server
• Синхронизация импортированного списка с внутренней базой данных (добавляются только новые записи, обновляются только измененные поля в существующих записях)
• Распечатка карточек с данными входа, в индивидуальном порядке или списком, основанным на результатах поиска (набор критериев или поиск по подстроке)
• Отправка сообщений электронной почте на основе критериев (выборки), упомянутых в предыдущем пункте (без групп распространения) с сохранением истории (необходим SMTP-сервер) 
• Подготовка CSV-файла в формате Powershell с учетом разницы формата добавления/обновления
• Поддержка шаблонов команд PowerShell, настроенных под нужды учебного заведения
• Создание всех необходимых файлов для запуска процесса создания и обновления учетных записей (CSV_parser.ps1, PS-сценарии с разбиением CSV-файлов на несколько для поддержки многопоточного режима, непосредственно списки в CSV-формате и т.д.) 
• Подготовка сценария создания групп распространения (списков рассылки – динамических и стандартных). Включение пользователей в группы основано на наборе параметров (академическая группа, факультет и т.д.). Эти данные автоматически извлекаются из базы данных.
• Создание учетных записей Active Directory, сохраняемых в организационном подразделении [Учебное заведение]->[Факультет]->[Академическая группа]->Пользователь
• Запуск сценариев PowerShell прямо из приложения (автозапуск консоли PS с запросом учетных данных – можно сохранить эти данные в шаблонах PS и запрос выдаваться не будет)
• Сохранение журнала выдачи персональных карточек с учетными данными. Журнал построен на базе GUID, что позволяет синхронизировать графики выдачи между разными филиалами.

PowerShell Assistant обладает рядом полезных характеристик:

• Многоязычность – любой язык интерфейса может быть добавлен по запросу  
• Настраиваемый – Вы можете устанавливать многие параметры, которые влияют на работу приложения, без редактирования кода
• Обновляемый – данные учебного заведения вынесены из основного файла, поэтому процесс обновления основного приложения становится проще

Для того, чтобы загрузить программу и получить дополнительную информацию, а также принять участие в обсуждении и задать вопрос, присоединяйтесь к группе https://psassistant.groups.live.com .  Также Вы можете воспользоваться порталом CodePlex сообщества Microsoft разработчиков приложений с открытым кодом по адресу https://psa.codeplex.com/ для загрузки приложения и документации, а также сообщения о проблемах и обсуждения приложения.

Необходимо настроить компьютер, на котором будет запускаться PSA, для работы с Remote PowerShell. Инструкции по настройке расположены по адресу https://help.outlook.com/ru-ru/140/cc546278(en-us).aspx .

Элемент управления подключается к Outlook Live для получения почты и событий календаря с использованием возможностей имперсонации.

Не забудьте подписать новое соглашение для получения возможности имперсонации. Чтобы проверить, переведена ли Ваша организация на новую услугу, воспользуйтесь инструкцией.