Командлеты PowerShell для режима SharePoint служб Reporting Services

При установке службы SQL Server 2014 Reporting Services в режиме SharePoint командлеты PowerShell устанавливаются для поддержки серверов отчетов в этом режиме. Командлеты охватывают три категории функциональных возможностей.

• Установка общей службы и прокси-сервера Служб Reporting Services SharePoint.

• Подготовка и управление приложениями-службами Reporting Services и связанными прокси-клиентами.

• Управление функциями служб Reporting Services, например расширениями и ключами шифрования.

Этот раздел содержит следующее:

• Сводка командных инструментов

• Командлеты общей службы и прокси-сервера

• Командлеты служебных приложений и прокси

• Командлеты пользовательских функций служб Reporting Services

• Основные примеры

• Подробные примеры

  • Создайте приложение службы Reporting Services и ее прокси-сервер

  • Проверка и обновление расширения доставки Reporting Services

  • Получение и задание свойств базы данных приложения Reporting Servicea, например время ожидания базы данных

  • Список расширений данных служб Reporting Services — режим SharePoint

  • Изменение и перечисление владельцев подписок

Сводка командлета

Чтобы запустить командлеты, откройте консоль управления SharePoint. Вы также можете использовать графический редактор пользовательского интерфейса, который входит в состав интегрированной среды сценариев (ISE) Microsoft Windows, Windows PowerShell. Дополнительные сведения см. в статье "Запуск Windows PowerShell на Windows Server". В следующих кратких описаниях командлетов ссылки на базы данных приложения службы относятся ко всем базам данных, созданным и используемым приложением службы Reporting Services. К ним относятся конфигурация, оповещения и временные базы данных.

Если при вводе примеров PowerShell отображается сообщение об ошибке, аналогичное следующему:

• Install-SPRSService: термин "Install-SPRSService" не распознается как
  имя командлета, функции, скриптового файла или исполняемой программы. Проверьте орфографию имени, или, если указан путь, убедитесь, что путь указан правильно и повторите попытку.

Возникает одна из следующих проблем:

• Режим SharePoint системы Reporting Services не установлен, поэтому командлеты Reporting Services не установлены.

• Вы выполнили команду PowerShell в Windows PowerShell или среде сценариев Windows PowerShell вместо оболочки управления SharePoint. Используйте оболочку управления SharePoint или добавьте оснастку SharePoint в окно Windows PowerShell с помощью следующей команды:

  Add-PSSnapin Microsoft.SharePoint.PowerShell  
  

Дополнительные сведения см. в статье Об использовании Windows PowerShell для администрирования SharePoint 2013 (https://technet.microsoft.com/library/ee806878.aspx).

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

1. Нажмите кнопку "Пуск "

2. Щелкните группу Microsoft SharePoint Products.

3. Щелкните оболочку управления SharePoint.

Чтобы просмотреть справку командной строки для командлета, используйте команду PowerShell Get-Help в командной строке PowerShell. Рассмотрим пример.

Get-Help Get-SPRSServiceApplicationServers

Командлеты общей службы и прокси-сервера

В следующей таблице содержатся командлеты PowerShell для общей службы Reporting Services в SharePoint.

Командлеты службы приложений и прокси-сервера

В следующей таблице содержатся командлеты PowerShell для приложений служб Reporting Services и связанных с ними прокси-серверов.

Командлеты пользовательской функциональности служб Reporting Services

Основные примеры

Возвращает список командлетов, содержащих spRS в имени. Это полный список командлетов Служб Reporting Services.

Get-command -noun *SPRS*  

Или с небольшими подробностями, переданным в текстовый файл с именем commandlist.txt

Get-Command -Noun *SPRS* | Select name, definition | Format-List | Out-File c:\commandlist.txt  

Установите службы отчетности SharePoint и их прокси-службу.

Install-SPRSService  

Install-SPRSServiceProxy  

Запуск службы Reporting Services

Get-SPServiceInstance -all | where {$_.TypeName -like "SQL Server Reporting*"} | Start-SPServiceInstance  

Введите следующую команду из командной консоли SharePoint, чтобы вернуть отфильтрованный список строк из файла журнала. Команда будет фильтровать строки, содержащие ssrscustomactionerror. Этот пример рассматривает файл журнала, созданный при установке rssharepoint.msi.

Get-Content -Path C:\Users\testuser\AppData\Local\Temp\rs_sp_0.log | Select-String "ssrscustomactionerror"  

Подробные примеры

Помимо приведенных ниже примеров, см. раздел "Скрипт Windows PowerShell" в разделе скрипта Windows PowerShell для шагов 1-4.

Создание приложения службы и прокси-сервера служб Reporting Services

В этом примере скрипта выполняются следующие задачи:

1. Создайте приложение службы Reporting Services и прокси-сервер. Сценарий предполагает, что пул приложений "Мой пул приложений" уже существует.

2. Добавление прокси-сервера в группу прокси по умолчанию

3. Предоставьте приложению-службе доступ к базе данных содержимого веб-приложения порта 80. В скрипте предполагается, что сайт "http://sitename" уже существует.

# Create service application and service application proxy  
$appPool = Get-SPServiceApplicationPool "My App Pool"  
$serviceApp = New-SPRSServiceApplication "My RS Service App" -ApplicationPool $appPool  
$serviceAppProxy = New-SPRSServiceApplicationProxy -Name "My RS Service App Proxy" -ServiceApplication $serviceApp  
  
# Add service application proxy to default proxy group.  Any web application that uses the default proxy group will now be able to use this service application.  
Get-SPServiceApplicationProxyGroup -default | Add-SPServiceApplicationProxyGroupMember -Member $serviceAppProxy  
  
# Grant application pool account access to the port 80 web application's content database.  
$webApp = Get-SPWebApplication "http://sitename"  
$appPoolAccountName = $appPool.ProcessAccount.LookupName()  
$webApp.GrantAccessToProcessIdentity($appPoolAccountName)

Обзор и обновление расширения доставки Служб отчетности

В следующем примере скрипта PowerShell обновляется конфигурация модуля доставки электронной почты сервера отчетов для приложения-службы с именем My RS Service App. Обновите значения SMTP-сервера (<email server name>) и псевдонима электронной почты FROM (<your FROM email address>).

$app = Get-SPRSServiceApplication -Name "My RS Service App"  
$emailCfg = Get-SPRSExtension -Identity $app -ExtensionType "Delivery" -Name "Report Server Email" | Select -ExpandProperty ConfigurationXml
$emailXml = [xml]$emailCfg
$emailXml.SelectSingleNode("//SMTPServer").InnerText = "<email server name>"  
$emailXml.SelectSingleNode("//SendUsing").InnerText = "2"  
$emailXml.SelectSingleNode("//SMTPAuthenticate").InnerText = "2"  
$emailXml.SelectSingleNode("//From").InnerText = '<your FROM email address>'  
Set-SPRSExtension -Identity $app -ExtensionType "Delivery" -Name "Report Server Email" -ExtensionConfiguration $emailXml.OuterXml  

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

$app = Get-SPRSServiceApplication | Where {$_.name -like " ssrs_testapp *"}  

Следующий скрипт вернет текущие значения конфигурации для модуля доставки электронной почты сервера отчетов для приложения службы с именем "Приложение служб Reporting Services". Первый шаг задает значение переменной $app объекту приложения-службы с именем "My RS Service App"

Второе утверждение получит расширение доставки "Электронная почта сервера отчетов" для объекта служебного приложения в переменной $app и выберет конфигурацию XML.

$app = Get-SPRSServiceapplication -Name "Reporting Services Application"  
Get-SPRSExtension -Identity $app -ExtensionType "Delivery" -Name "Report Server Email" | Select -ExpandProperty ConfigurationXml  

Вы также можете переписать приведенные выше два оператора как одно:

Get-SPRSServiceApplication -Name "Reporting Services Application" | Get-SPRSExtension -ExtensionType "Delivery" -Name "Report Server Email" | Select -ExpandProperty ConfigurationXml  

Получение и задание свойств базы данных приложения Reporting Servicea, например время ожидания базы данных

В следующем примере сначала возвращается список баз данных и свойств, чтобы можно было определить guid базы данных (идентификатор), который затем предоставляется команде set. Для полного списка свойств используйте Get-SPRSDatabase | format-list.

Get-SPRSDatabase | Select id, querytimeout,connectiontimeout, status, server, ServiceInstance

Ниже приведен пример выходных данных. Определите идентификатор базы данных, которую необходимо изменить, и используйте его в командлете SET.

• Id : 56f8d1bc-cb04-44cf-bd41-a873643c5a14

  QueryTimeout : 120

  ConnectionTimeout : 15

  Status : Online

  Server : SPServer Name=uetestb01

  ServiceInstance : SPDatabaseServiceInstance

Set-SPRSDatabase -Identity 56f8d1bc-cb04-44cf-bd41-a873643c5a14 -QueryTimeout 300  

Чтобы проверить, задано ли значение, снова запустите командлет GET.

Get-SPRSDatabase -Identity 56f8d1bc-cb04-44cf-bd41-a873643c5a14 | Select id, querytimeout,connectiontimeout, status, server, ServiceInstance  

Список расширений данных Reporting Services в режиме SharePoint

В следующем примере поочередно обрабатывается каждое приложение службы Reporting Services и перечисляются текущие расширения данных для каждого.

$apps = Get-SPRSServiceApplication  
foreach ($app in $apps)
{  
Write-host -ForegroundColor "yellow" Service App Name $app.Name  
Get-SPRSExtension -identity $app -ExtensionType "Data" | select name, extensiontype | Format-Table -AutoSize  
}  

Пример выходных данных:

• Name ExtensionType

  ---- -------------

  SQL Data

  SQLAZURE Data

  SQLPDW Data

  OLEDB Data

  OLEDB-MD Data

  ORACLE Data

  ODBC Data

  XML Data

  SHAREPOINTLIST Data

Изменение и перечисление владельцев подписок

См. статью "Использование PowerShell для изменения и перечисления владельцев подписок служб Reporting Services" и запуска подписки.

См. также

Использование PowerShell для изменения и перечисления владельцев подписок в службах отчетности и запуска подписки
Контрольный список. Использование PowerShell для проверки PowerPivot для SharePoint
Скрипты PowerShell для управления SharePoint от CodePlex