Use PowerShell to Change and List Reporting Services Subscription Owners and Run a Subscription

Статья
03/06/2017

Начиная с версии Reporting Services для SQL Server 2008 R2 вы можете программно передавать владение подпиской Reporting Services от одного пользователя другому. В этом разделе содержится несколько скриптов Windows PowerShell, которые можно использовать для смены владельца подписки или простого перечисления владельцев. В каждом примере содержится образец синтаксиса для собственного режима и режима SharePoint. После смены владельца подписки подписка будет выполняться в контексте безопасности нового владельца, а в отчете в поле «User!UserID» будет отображаться значение нового владельца. Дополнительные сведения об объектной модели вызовов образцов см. в разделе ChangeSubscriptionOwner

Содержимое, связанное с PowerShell


Применимо к: Reporting Services в собственном режиме \| Reporting Services в режиме интеграции с SharePoint

В этом разделе:

Использование скриптов
Скрипт. Вывод списка владельцев всех подписок
Скрипт. Вывод списка подписок, принадлежащих конкретному пользователю
Скрипт. Смена владельца всех подписок, принадлежащих конкретному пользователю
Скрипт. Вывод списка всех подписок, связанных с конкретным отчетом
Скрипт. Смена владельца конкретной подписки
Скрипт. Запуск (инициация) одной подписки

Использование скриптов

Разрешения

В этом разделе приводится сводка по уровням разрешений, необходимым для использования каждого метода Reporting Services в собственном режиме и в режиме интеграции с SharePoint. В скриптах, рассматриваемых в этом разделе, используются следующие методы Reporting Services.

Метод ReportingService2010.ListSubscriptions
Метод ReportingService2010.ChangeSubscriptionOwner
ReportingService2010.ListChildren
Метод ReportingService2010.FireEvent используется только в последнем скрипте для запуска конкретной подписки. Если использовать этот скрипт не планируется, можно проигнорировать требования к методу FireEvent.

Собственный режим.

Список подписок: ( HYPERLINK "https://technet.microsoft.com/library/microsoft.reportingservices.interfaces.reportoperation.aspx" ReadSubscription в отчете И пользователь является владельцем подписки) ИЛИ ReadAnySubscription
Изменение подписок: Пользователь должен входить в группу BUILTIN\Administrators
Вывод списка дочерних элементов: Свойства ReadProperties для элемента
Вызов события: GenerateEvents (System)

Режим интеграции с SharePoint:

Список подписок: ManageAlerts OR ( HYPERLINK "https://technet.microsoft.com/library/microsoft.sharepoint.spbasepermissions.aspx" CreateAlerts в отчете. Пользователь является владельцем подписки, а подписка — подписка по времени.
Изменение подписок: ManageWeb
Вывод списка дочерних элементов: ViewListItems
Вызов события: ManageWeb

Дополнительные сведения см. в разделе Сравнение ролей и задач служб Reporting Services с группами и разрешениями SharePoint.

Использование скрипта

Создание файлов скрипта (PS1)

Создайте папку с именем c:\scripts. Если выбирается другая папка, измените имя папки, используемое в конструкциях синтаксиса командной строки в примере.
Для каждого скрипта создайте текстовый файл и сохраните файлы в папку c:\scripts. При создании файлов PS1 используйте имена из каждого синтаксиса командной строки в примере.
Откройте окно командной строки с правами администратора.
С помощью приведенного в каждом примере синтаксиса командной строки выполните каждый скрипт.

Тестовые среды

Скрипты, приведенные в данном разделе, были протестированы в PowerShell версии 3 и со следующими версиями Reporting Services:

SQL Server 2014
SQL Server 2012
SQL Server 2008 R2

Скрипт: вывод списка владельцев всех подписок

Этот скрипт выводит список всех подписок на одной сайте. С помощью этого скрипта можно проверить подключение или проверить путь к отчету и ИД подписки для использования в других скриптах. Этот скрипт упрощает аудит существующих подписок и их владельцев.

Синтаксис собственного режима

powershell c:\scripts\ListAll_SSRS_Subscriptions.ps1 "[server]/reportserver" "/"

Синтаксис режима SharePoint

powershell c:\scripts\ListAll_SSRS_Subscriptions.ps1 "[server]/_vti_bin/reportserver" "http://[server]"

Скрипт

# Parameters
#    server   - server and instance name (e.g. myserver/reportserver or myserver/reportserver_db2)

Param(
    [string]$server,
    [string]$site
   )

$rs2010 += New-WebServiceProxy -Uri "http://$server/ReportService2010.asmx" -Namespace SSRS.ReportingService2010 -UseDefaultCredential ;
$subscriptions += $rs2010.ListSubscriptions($site); # use "/" for default native mode site

Write-Host " "
Write-Host "----- $server's Subscriptions: "
$subscriptions | select Path, report, Description, Owner, SubscriptionID, lastexecuted, Status

Совет

Чтобы проверить URL-адреса сайтов в режиме SharePoint, воспользуйтесь командлетом SharePoint Get-SPSite. Дополнительные сведения см. в статье Get-SPSite.

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

Этот скрипт перечисляет все подписки, принадлежащие конкретному пользователю. С помощью этого скрипта можно проверить подключение или проверить путь к отчету и ИД подписки для использования в других скриптах. Этот скрипт полезен в случае, если какой-либо сотрудник увольняется из организации и необходимо проверить принадлежащие ему подписки, чтобы в дальнейшем сменить владельца или удалить подписку.

Синтаксис собственного режима

powershell c:\scripts\ListAll_SSRS_Subscriptions4User.ps1 "[Domain]\[user]" "[server]/reportserver" "/"

Синтаксис режима SharePoint

powershell c:\scripts\ListAll_SSRS_Subscriptions4User.ps1 "[Domain]\[user]"  "[server]/_vti_bin/reportserver" "http://[server]"

Скрипт

# Parameters:
#    currentOwner - DOMAIN\USER that owns the subscriptions you wish to change
#    server        - server and instance name (e.g. myserver/reportserver or myserver/reportserver_db2)
#    site        - use "/" for default native mode site
Param(
    [string]$currentOwner,
    [string]$server,
    [string]$site
)

$rs2010 = New-WebServiceProxy -Uri "http://$server/ReportService2010.asmx" -Namespace SSRS.ReportingService2010 -UseDefaultCredential ;
$subscriptions += $rs2010.ListSubscriptions($site);

Write-Host " "
Write-Host " "
Write-Host "----- $currentOwner's Subscriptions: "
$subscriptions | select Path, report, Description, Owner, SubscriptionID, lastexecuted,Status | where {$_.owner -eq $currentOwner}

Скрипт: смена владельца всех подписок, принадлежащих конкретному пользователю

Этот скрипт меняет владельца подписок, принадлежащих конкретному пользователю параметр нового владельца.

Синтаксис собственного режима

powershell c:\scripts\ChangeALL_SSRS_SubscriptionOwner.ps1 "[Domain]\current owner]" "[Domain]\[new owner]" "[server]/reportserver"

Синтаксис режима SharePoint

powershell c:\scripts\ChangeALL_SSRS_SubscriptionOwner.ps1 "[Domain]\{current owner]" "[Domain]\[new owner]" "[server]/_vti_bin/reportserver"

Скрипт

# Parameters:
#    currentOwner - DOMAIN\USER that owns the subscriptions you wish to change
#    newOwner      - DOMAIN\USER that will own the subscriptions you wish to change
#    server        - server and instance name (e.g. myserver/reportserver, myserver/reportserver_db2, myserver/_vti_bin/reportserver)

Param(
    [string]$currentOwner,
    [string]$newOwner,
    [string]$server
)

$rs2010 = New-WebServiceProxy -Uri "http://$server/ReportService2010.asmx" -Namespace SSRS.ReportingService2010 -UseDefaultCredential ;
$items = $rs2010.ListChildren("/", $true);

$subscriptions = @();

ForEach ($item in $items)
{
    if ($item.TypeName -eq "Report")
    {
        $curRepSubs = $rs2010.ListSubscriptions($item.Path);
        ForEach ($curRepSub in $curRepSubs)
        {
            if ($curRepSub.Owner -eq $currentOwner)
            {
                $subscriptions += $curRepSub;
            }
        }
    }
}

Write-Host " "
Write-Host " "
Write-Host -foregroundcolor "green" "-----  $currentOwner's Subscriptions changing ownership to $newOwner : "
$subscriptions | select SubscriptionID, Owner, Path, Description,  Status  | format-table -AutoSize

ForEach ($sub in $subscriptions)
{
    $rs2010.ChangeSubscriptionOwner($sub.SubscriptionID, $newOwner);
}

$subs2 = @();

ForEach ($item in $items)
{
    if ($item.TypeName -eq "Report")
    {
        $subs2 += $rs2010.ListSubscriptions($item.Path);
    }
}

Скрипт: вывод списка всех подписок, связанных с конкретным отчетом

Этот скрипт перечисляет все подписки, связанные с конкретным отчетом. В синтаксисе пути к отчету требуется использовать полный URL-адрес. В примерах синтаксиса в имени отчета указывается только название, содержащее пробел. Поэтому имя отчета следует заключить в одинарные кавычки.

Синтаксис собственного режима

powershell c:\scripts\List_SSRS_One_Reports_Subscriptions.ps1 "[server]/reportserver" "'/reports/title only'" "/"

Синтаксис режима SharePoint

powershell c:\scripts\List_SSRS_One_Reports_Subscriptions.ps1 "[server]/_vti_bin/reportserver"  "'http://[server]/shared documents/title only.rdl'" "http://[server]"

Скрипт

# Parameters:
#    server      - server and instance name (e.g. myserver/reportserver or myserver/reportserver_db2)
#    reportpath  - path to report in the report server, including report name e.g. /reports/test report >> pass in  "'/reports/title only'"
#    site        - use "/" for default native mode site
Param
(
      [string]$server,
      [string]$reportpath,
      [string]$site
)

$rs2010 = New-WebServiceProxy -Uri "http://$server/ReportService2010.asmx" -Namespace SSRS.ReportingService2010 -UseDefaultCredential ;
$subscriptions += $rs2010.ListSubscriptions($site);

Write-Host " "
Write-Host " "
Write-Host "----- $reportpath 's Subscriptions: "
$subscriptions | select Path, report, Description, Owner, SubscriptionID, lastexecuted,Status | where {$_.path -eq $reportpath}

Скрипт: смена владельца конкретной подписки

Этот сценарий меняет владельца конкретной подписки. Подписка идентифицируется по SubscriptionID, указанному в скрипте. Чтобы определить правильный SubscriptionID, можно воспользоваться одним из скриптов вывода списка подписок.

Синтаксис собственного режима

powershell c:\scripts\Change_SSRS_Owner_One_Subscription.ps1 "[Domain]\[new owner]" "[server]/reportserver" "/" "ac5637a1-9982-4d89-9d69-a72a9c3b3150"

Синтаксис режима SharePoint

powershell c:\scripts\Change_SSRS_Owner_One_Subscription.ps1 "[Domain]\[new owner]" "[server]/_vti_bin/reportserver" "http://[server]" "9660674b-f020-453f-b1e3-d9ba37624519"

Скрипт

# Parameters:
#    newOwner       - DOMAIN\USER that will own the subscriptions you wish to change
#    server         - server and instance name (e.g. myserver/reportserver or myserver/reportserver_db2)
#    site        - use "/" for default native mode site
#    subscriptionID - guid for the single subscription to change

Param(
    [string]$newOwner,
    [string]$server,
    [string]$site,
    [string]$subscriptionid
   )
$rs2010 = New-WebServiceProxy -Uri "http://$server/ReportService2010.asmx" -Namespace SSRS.ReportingService2010 -UseDefaultCredential;

$subscription += $rs2010.ListSubscriptions($site) | where {$_.SubscriptionID -eq $subscriptionid};

Write-Host " "
Write-Host "----- $subscriptionid's Subscription properties: "
$subscription | select Path, report, Description, SubscriptionID, Owner, Status

$rs2010.ChangeSubscriptionOwner($subscription.SubscriptionID, $newOwner)

#refresh the list
$subscription = $rs2010.ListSubscriptions($site) | where {$_.SubscriptionID -eq $subscriptionid}; # use "/" for default native mode site
Write-Host "----- $subscriptionid's Subscription properties: "
$subscription | select Path, report, Description, SubscriptionID, Owner, Status

Скрипт: запуск (вызов) одной подписки

Этот скрипт запускает определенную подписку с помощью метода FireEvent. Независимо от настроенного для подписки расписания скрипт запустит подписку немедленно. EventType сопоставляется с известным набором событий, которые определены в файле конфигурации сервера отчетов rsreportserver.config . Скрипт использует следующий тип событий для стандартных подписок:

<Event>

<Type>TimedSubscription</Type>

</Event>

Дополнительные сведения о файле конфигурации см. в разделе RSReportServer Configuration File.

Скрипт содержит логику задержки "Start-Sleep -s 6", поэтому после запуска события есть небольшой период времени для ввода обновленного состояния в метод ListSubscription.

Синтаксис собственного режима

powershell c:\scripts\FireSubscription.ps1 "[server]/reportserver" $null "70366e82-2d3c-4edd-a216-b97e51e26de9"

Синтаксис режима SharePoint

powershell c:\scripts\FireSubscription.ps1 "[server]/_vti_bin/reportserver" "http://[server]" "c3425c72-580d-423e-805a-41cf9799fd25"

Скрипт

# Parameters
#    server         - server and instance name (e.g. myserver/reportserver or myserver/reportserver_db2)
#    site           - use $null for a native mode server
#    subscriptionid - subscription guid

Param(
  [string]$server,
  [string]$site,
  [string]$subscriptionid
  )

$rs2010 = New-WebServiceProxy -Uri "http://$server/ReportService2010.asmx" -Namespace SSRS.ReportingService2010 -UseDefaultCredential ;
#event type is case sensative to what is in the rsreportserver.config
$rs2010.FireEvent("TimedSubscription",$subscriptionid,$site)

Write-Host " "
Write-Host "----- Subscription ($subscriptionid) status: "
#get list of subscriptions and filter to the specific ID to see the Status and LastExecuted
Start-Sleep -s 6 # slight delay in processing so ListSubscription returns the updated Status and LastExecuted
$subscriptions = $rs2010.ListSubscriptions($site); 
$subscriptions | select Status, Path, report, Description, Owner, SubscriptionID, EventType, lastexecuted | where {$_.SubscriptionID -eq $subscriptionid}

См. также:

ListSubscriptions ChangeSubscriptionOwner ListChildren FireEvent

Поделиться через

Use PowerShell to Change and List Reporting Services Subscription Owners and Run a Subscription

Использование скриптов

Разрешения

Использование скрипта

Скрипт: вывод списка владельцев всех подписок

Синтаксис собственного режима

Синтаксис режима SharePoint

Скрипт

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

Синтаксис собственного режима

Синтаксис режима SharePoint

Скрипт

Скрипт: смена владельца всех подписок, принадлежащих конкретному пользователю

Синтаксис собственного режима

Синтаксис режима SharePoint

Скрипт

Скрипт: вывод списка всех подписок, связанных с конкретным отчетом

Синтаксис собственного режима

Синтаксис режима SharePoint

Скрипт

Скрипт: смена владельца конкретной подписки

Синтаксис собственного режима

Синтаксис режима SharePoint

Скрипт

Скрипт: запуск (вызов) одной подписки

Синтаксис собственного режима

Синтаксис режима SharePoint

Скрипт

См. также:

Дополнительные ресурсы