Permalink
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
870 lines (573 sloc) 35.4 KB

ITG.Yandex

Обёртки для API Яндекс - базовый модуль для поддержки API различных сервисов Яндекса.

Версия модуля: 2.0.1

Функции модуля

Admin

Обзор Get-Admin

Метод (обёртка над Яндекс.API get_admins). Метод позволяет получить список дополнительных администраторов домена.

Get-Admin [-DomainName] <String> <CommonParameters>

Подробнее - Get-Admin.

Обзор Register-Admin

Метод (обёртка над Яндекс.API set_admin) предназначен для указания логина дополнительного администратора домена.

Register-Admin -DomainName <String> [-Credential] <String> [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>

Подробнее - Register-Admin.

Обзор Remove-Admin

Метод (обёртка над Яндекс.API del_admin) предназначен для удаления дополнительного администратора домена.

Remove-Admin -DomainName <String> [-Credential] <String> [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>

Подробнее - Remove-Admin.

API

Обзор Invoke-API

Обёртка для вызовов методов API Яндекс. Предназначена для внутреннего использования.

Invoke-API [[-HttpMethod] <String>] [[-Token] <SecureString>] [-method] <String> [-DomainName] <String> [[-Params] <IDictionary>] [[-IsSuccessPredicate] <ScriptBlock>] [[-IsFailurePredicate] <ScriptBlock>] [[-ResultFilter] <ScriptBlock>] [[-SuccessMsg] <String>] [[-FailureMsg] <String>] [[-FailureMsgFilter] <ScriptBlock>] [[-UnknownErrorMsg] <String>] [-WhatIf] [-Confirm] <CommonParameters>

Подробнее - Invoke-API.

Domain

Обзор Register-Domain

Метод (обёртка над Яндекс.API reg_domain) предназначен для регистрации домена на сервисах Яндекса.

Register-Domain [-DomainName] <String> [-Token] <SecureString> [-WhatIf] [-Confirm] <CommonParameters>

Подробнее - Register-Domain.

Обзор Remove-Domain

Метод (обёртка над Яндекс.API del_domain) предназначен для отключения домена от Яндекс.Почта для доменов.

Remove-Domain [-DomainName] <String> [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>

Подробнее - Remove-Domain.

Logo

Обзор Remove-Logo

Метод (обёртка над Яндекс.API del_logo) предназначен для удаления логотипа домена.

Remove-Logo [-DomainName] <String> [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>

Подробнее - Remove-Logo.

Обзор Set-Logo

Метод (обёртка над Яндекс.API add_logo) предназначен для установки логотипа для домена.

Set-Logo [-DomainName] <String> [-Path] <FileInfo> [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>

Подробнее - Set-Logo.

Token

Обзор Get-Token

Метод (обёртка над Яндекс.API get_token) предназначен для получения авторизационного токена.

Get-Token [-DomainName] <String> [-NoCache] <CommonParameters>

Подробнее - Get-Token.

Обзор Set-Token

Установка токена для других методов API.

Set-Token [-DomainName] <String> [-Token] <SecureString> <CommonParameters>

Подробнее - Set-Token.

Подробное описание функций модуля

Get-Admin

Метод (обёртка над Яндекс.API get_admins). Метод позволяет получить список дополнительных администраторов домена.

Синтаксис
Get-Admin [-DomainName] <String> <CommonParameters>
Компонент

API Яндекс.Почты для доменов

Параметры
  • DomainName <String> имя домена, зарегистрированного на сервисах Яндекса

      Требуется? true
      Позиция? 1
      Значение по умолчанию
      Принимать входные данные конвейера?true (ByValue, ByPropertyName)
      Принимать подстановочные знаки?false
    
  • <CommonParameters> Этот командлет поддерживает общие параметры: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer и OutVariable. Для получения дополнительных сведений см. раздел about_CommonParameters.

Примеры использования
  1. Пример 1.

     Get-Admin -DomainName 'csm.nov.ru';
    
См. также

Register-Admin

Метод (обёртка над Яндекс.API set_admin) предназначен для указания логина дополнительного администратора домена. В качестве логина может быть указан только логин на @yandex.ru, но не на домене, делегированном на Яндекс.

Синтаксис
Register-Admin -DomainName <String> [-Credential] <String> [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>
Компонент

API Яндекс.Почты для доменов

Параметры
  • DomainName <String> имя домена, зарегистрированного на сервисах Яндекса

      Требуется? true
      Позиция? named
      Значение по умолчанию
      Принимать входные данные конвейера?true (ByValue, ByPropertyName)
      Принимать подстановочные знаки?false
    
  • Credential <String> Логин дополнительного администратора на @yandex.ru

      Требуется? true
      Позиция? 1
      Значение по умолчанию
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • PassThru [<SwitchParameter>] передавать домены далее по конвейеру или нет

      Требуется? false
      Позиция? named
      Значение по умолчанию False
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • WhatIf [<SwitchParameter>]

      Требуется? false
      Позиция? named
      Значение по умолчанию
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • Confirm [<SwitchParameter>]

      Требуется? false
      Позиция? named
      Значение по умолчанию
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • <CommonParameters> Этот командлет поддерживает общие параметры: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer и OutVariable. Для получения дополнительных сведений см. раздел about_CommonParameters.

Примеры использования
  1. Пример 1.

     Register-Admin -DomainName 'csm.nov.ru' -Credential 'sergei.e.gushchin';
    
См. также

Remove-Admin

Метод (обёртка над Яндекс.API del_admin) предназначен для удаления дополнительного администратора домена. В качестве логина может быть указан только логин на @yandex.ru, но не на домене, делегированном на Яндекс.

Синтаксис
Remove-Admin -DomainName <String> [-Credential] <String> [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>
Компонент

API Яндекс.Почты для доменов

Параметры
  • DomainName <String> имя домена, зарегистрированного на сервисах Яндекса

      Требуется? true
      Позиция? named
      Значение по умолчанию
      Принимать входные данные конвейера?true (ByValue, ByPropertyName)
      Принимать подстановочные знаки?false
    
  • Credential <String> Логин дополнительного администратора на @yandex.ru

      Требуется? true
      Позиция? 1
      Значение по умолчанию
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • PassThru [<SwitchParameter>] передавать домены далее по конвейеру или нет

      Требуется? false
      Позиция? named
      Значение по умолчанию False
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • WhatIf [<SwitchParameter>]

      Требуется? false
      Позиция? named
      Значение по умолчанию
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • Confirm [<SwitchParameter>]

      Требуется? false
      Позиция? named
      Значение по умолчанию
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • <CommonParameters> Этот командлет поддерживает общие параметры: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer и OutVariable. Для получения дополнительных сведений см. раздел about_CommonParameters.

Примеры использования
  1. Пример 1.

     Remove-Admin -DomainName 'csm.nov.ru' -Credential 'sergei.e.gushchin';
    
См. также

Invoke-API

Обёртка для вызовов методов API Яндекс. Предназначена для внутреннего использования.

Синтаксис
Invoke-API [[-HttpMethod] <String>] [[-Token] <SecureString>] [-method] <String> [-DomainName] <String> [[-Params] <IDictionary>] [[-IsSuccessPredicate] <ScriptBlock>] [[-IsFailurePredicate] <ScriptBlock>] [[-ResultFilter] <ScriptBlock>] [[-SuccessMsg] <String>] [[-FailureMsg] <String>] [[-FailureMsgFilter] <ScriptBlock>] [[-UnknownErrorMsg] <String>] [-WhatIf] [-Confirm] <CommonParameters>
Компонент

API Яндекс

Передаваемые по конвейеру данные
  • [xml] - Результат, возвращённый API.
Параметры
  • HttpMethod <String> HTTP метод вызова API

      Требуется? false
      Позиция? 1
      Значение по умолчанию GET
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • Token <SecureString> авторизационный токен, полученный через Get-Token

      Требуется? false
      Позиция? 2
      Значение по умолчанию
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • method <String> метод API - компонент url

      Требуется? true
      Позиция? 3
      Значение по умолчанию
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • DomainName <String> имя домена для регистрации на сервисах Яндекса

      Требуется? true
      Позиция? 4
      Значение по умолчанию
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • Params <IDictionary> коллекция параметров метода API

      Требуется? false
      Позиция? 5
      Значение по умолчанию @{}
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • IsSuccessPredicate <ScriptBlock> предикат успешного выполнения метода API

      Требуется? false
      Позиция? 6
      Значение по умолчанию { [bool]$_.action.status.success }
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • IsFailurePredicate <ScriptBlock> предикат ошибки при выполнении метода API. Если ни один из предикатов не вернёт $true - генерируем неизвестную ошибку

      Требуется? false
      Позиция? 7
      Значение по умолчанию { [bool]$_.action.status.error }
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • ResultFilter <ScriptBlock> фильтр обработки результата. Если фильтр не задан - функция не возвращает результат

      Требуется? false
      Позиция? 8
      Значение по умолчанию {}
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • SuccessMsg <String> Шаблон сообщения об успешном выполнении API

      Требуется? false
      Позиция? 9
      Значение по умолчанию "Метод API $method успешно выполнен для домена $DomainName."
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • FailureMsg <String> Шаблон сообщения об ошибке вызова API

      Требуется? false
      Позиция? 10
      Значение по умолчанию "Ошибка при вызове метода API $method для домена $DomainName"
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • FailureMsgFilter <ScriptBlock> Фильтр обработки результата для выделения сообщения об ошибке

      Требуется? false
      Позиция? 11
      Значение по умолчанию { $_.action.status.error.'#text' }
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • UnknownErrorMsg <String> Шаблон сообщения о недиагностируемой ошибке вызова API

      Требуется? false
      Позиция? 12
      Значение по умолчанию "Неизвестная ошибка при вызове метода API $method для домена $DomainName."
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • WhatIf [<SwitchParameter>]

      Требуется? false
      Позиция? named
      Значение по умолчанию
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • Confirm [<SwitchParameter>]

      Требуется? false
      Позиция? named
      Значение по умолчанию
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • <CommonParameters> Этот командлет поддерживает общие параметры: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer и OutVariable. Для получения дополнительных сведений см. раздел about_CommonParameters.

Register-Domain

Метод регистрирует домен на сервисах Яндекса. Если домен уже подключен, то метод reg_domain не выполняет никаких действий.

Синтаксис
Register-Domain [-DomainName] <String> [-Token] <SecureString> [-WhatIf] [-Confirm] <CommonParameters>
Компонент

API Яндекс.Почты для доменов

Параметры
  • DomainName <String> имя домена для регистрации на сервисах Яндекса

      Требуется? true
      Позиция? 1
      Значение по умолчанию
      Принимать входные данные конвейера?true (ByValue, ByPropertyName)
      Принимать подстановочные знаки?false
    
  • Token <SecureString> авторизационный токен, полученный через Get-Token, для другого, уже зарегистрированного домена

      Требуется? true
      Позиция? 2
      Значение по умолчанию
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • WhatIf [<SwitchParameter>]

      Требуется? false
      Позиция? named
      Значение по умолчанию
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • Confirm [<SwitchParameter>]

      Требуется? false
      Позиция? named
      Значение по умолчанию
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • <CommonParameters> Этот командлет поддерживает общие параметры: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer и OutVariable. Для получения дополнительных сведений см. раздел about_CommonParameters.

Примеры использования
  1. Регистрация нескольких доменов

     $token = Get-Token -DomainName 'maindomain.ru';	'domain1.ru', 'domain2.ru' | Register-Domain -Token $token;
    
См. также

Remove-Domain

Метод позволяет отключить домен. Отключенный домен перестает выводиться в списке доменов. После отключения домен можно подключить заново. Отключение домена не влечет за собой изменения MX-записей. MX-записи нужно устанавливать отдельно на DNS-серверах, куда делегирован домен.

Синтаксис
Remove-Domain [-DomainName] <String> [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>
Компонент

API Яндекс.Почты для доменов

Параметры
  • DomainName <String> имя домена для регистрации на сервисах Яндекса

      Требуется? true
      Позиция? 1
      Значение по умолчанию
      Принимать входные данные конвейера?true (ByValue, ByPropertyName)
      Принимать подстановочные знаки?false
    
  • PassThru [<SwitchParameter>] передавать домены далее по конвейеру или нет

      Требуется? false
      Позиция? named
      Значение по умолчанию False
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • WhatIf [<SwitchParameter>]

      Требуется? false
      Позиция? named
      Значение по умолчанию
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • Confirm [<SwitchParameter>]

      Требуется? false
      Позиция? named
      Значение по умолчанию
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • <CommonParameters> Этот командлет поддерживает общие параметры: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer и OutVariable. Для получения дополнительных сведений см. раздел about_CommonParameters.

Примеры использования
  1. Пример 1.

     Remove-Domain -DomainName 'test.ru';
    
См. также

Remove-Logo

Метод позволяет удалить логотип домена.

Синтаксис
Remove-Logo [-DomainName] <String> [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>
Компонент

API Яндекс.Почты для доменов

Параметры
  • DomainName <String> имя домена - любой из доменов, зарегистрированных под Вашей учётной записью на сервисах Яндекса

      Требуется? true
      Позиция? 1
      Значение по умолчанию
      Принимать входные данные конвейера?true (ByValue, ByPropertyName)
      Принимать подстановочные знаки?false
    
  • PassThru [<SwitchParameter>] передавать домены далее по конвейеру или нет

      Требуется? false
      Позиция? named
      Значение по умолчанию False
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • WhatIf [<SwitchParameter>]

      Требуется? false
      Позиция? named
      Значение по умолчанию
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • Confirm [<SwitchParameter>]

      Требуется? false
      Позиция? named
      Значение по умолчанию
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • <CommonParameters> Этот командлет поддерживает общие параметры: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer и OutVariable. Для получения дополнительных сведений см. раздел about_CommonParameters.

Примеры использования
  1. Удаление логотипа для домена yourdomain.ru.

     Remove-Logo -DomainName 'yourdomain.ru';
    
  2. Удаление логотипа для нескольких доменов.

     'domain1.ru', 'domain2.ru' | Remove-Logo;
    
См. также

Set-Logo

Метод позволяет установить логотип домена. Поддерживаются графические файлы форматов jpg, gif, png размером до 2 Мбайт.

Синтаксис
Set-Logo [-DomainName] <String> [-Path] <FileInfo> [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>
Компонент

API Яндекс.Почты для доменов

Параметры
  • DomainName <String> имя домена - любой из доменов, зарегистрированных под Вашей учётной записью на сервисах Яндекса

      Требуется? true
      Позиция? 1
      Значение по умолчанию
      Принимать входные данные конвейера?true (ByValue, ByPropertyName)
      Принимать подстановочные знаки?false
    
  • Path <FileInfo> путь к файлу логотипа. Поддерживаются графические файлы форматов jpg, gif, png размером до 2 Мбайт

      Требуется? true
      Позиция? 2
      Значение по умолчанию
      Принимать входные данные конвейера?true (ByPropertyName)
      Принимать подстановочные знаки?false
    
  • PassThru [<SwitchParameter>] передавать домены далее по конвейеру или нет

      Требуется? false
      Позиция? named
      Значение по умолчанию False
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • WhatIf [<SwitchParameter>]

      Требуется? false
      Позиция? named
      Значение по умолчанию
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • Confirm [<SwitchParameter>]

      Требуется? false
      Позиция? named
      Значение по умолчанию
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • <CommonParameters> Этот командлет поддерживает общие параметры: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer и OutVariable. Для получения дополнительных сведений см. раздел about_CommonParameters.

Примеры использования
  1. Установка логотипа для домена yourdomain.ru

     Set-Logo -DomainName 'yourdomain.ru' -Path 'c:\work\logo.png';
    
См. также

Get-Token

Метод get_token предназначен для получения авторизационного токена. Авторизационный токен используется для активации API Яндекс.Почты для доменов. Получать токен нужно только один раз. Чтобы получить токен, следует иметь подключенный домен, авторизоваться его администратором.

Данная функция возвращает непосредственно токен, либо генерирует исключение.

Синтаксис
Get-Token [-DomainName] <String> [-NoCache] <CommonParameters>
Компонент

API Яндекс

Передаваемые по конвейеру данные
  • [System.Security.SecureString] - собственно token
Параметры
  • DomainName <String> имя домена - любой из доменов, зарегистрированных под Вашей учётной записью на сервисах Яндекса

      Требуется? true
      Позиция? 1
      Значение по умолчанию
      Принимать входные данные конвейера?true (ByValue)
      Принимать подстановочные знаки?false
    
  • NoCache [<SwitchParameter>] данный флаг указывает на необходимость принудительного запроса токена, минуя кеш

      Требуется? false
      Позиция? named
      Значение по умолчанию False
      Принимать входные данные конвейера?false
      Принимать подстановочные знаки?false
    
  • <CommonParameters> Этот командлет поддерживает общие параметры: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer и OutVariable. Для получения дополнительных сведений см. раздел about_CommonParameters.

Примеры использования
  1. Получение токена для домена yourdomain.ru.

     $token = Get-Token -DomainName 'yourdomain.ru';
    
См. также

Set-Token

Данный метод позволяет задать токен, полученный ранее через Get-Token, для последующих вызовов командлет данного модуля.

Синтаксис
Set-Token [-DomainName] <String> [-Token] <SecureString> <CommonParameters>
Компонент

API Яндекс

Параметры
  • DomainName <String> имя домена - любой из доменов, зарегистрированных под Вашей учётной записью на сервисах Яндекса

      Требуется? true
      Позиция? 1
      Значение по умолчанию
      Принимать входные данные конвейера?true (ByPropertyName)
      Принимать подстановочные знаки?false
    
  • Token <SecureString> авторизационный токен, полученный через Get-Token

      Требуется? true
      Позиция? 2
      Значение по умолчанию
      Принимать входные данные конвейера?true (ByPropertyName)
      Принимать подстановочные знаки?false
    
  • <CommonParameters> Этот командлет поддерживает общие параметры: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer и OutVariable. Для получения дополнительных сведений см. раздел about_CommonParameters.

Примеры использования
  1. Задание токена для домена yourdomain.ru.

     Set-Token -DomainName 'yourdomain.ru' -Token $SecureStringToken;
    

Генератор: ITG.Readme.