管理订阅所有者并运行订阅 - PowerShell

项目
09/25/2024

适用于：SQL Server 2016 (13.x) Reporting Services 及更高版本 SharePoint

从 SQL Server 2008 R2 (10.50.x) Reporting Services 开始，可以编程方式将 Reporting Services 订阅的所有权从一个用户转让给另一个用户。本文提供多个 Windows PowerShell 脚本，这些脚本可用于更改订阅所有权，或只是列出订阅所有权。每个示例都包含本机模式和 SharePoint 模式的语法示例。更改订阅的所有者后，订阅将在新所有者的安全上下文中执行，并且报表中的 User!UserID 字段会显示新所有者的值。有关 PowerShell 示例调用的对象模型的详细信息，请参阅 ChangeSubscriptionOwner。

如何使用脚本

权限

本节总结了使用各本机模式和 SharePoint 模式 Reporting Services 方法所需的权限级别。本文中的脚本使用以下 Reporting Services 方法：

ReportingService2010.ListSubscriptions 方法
ReportingService2010.ChangeSubscriptionOwner 方法
ReportingService2010.ListChildren
ReportingService2010.FireEvent 方法仅在最后一个脚本中使用，以触发特定订阅运行。如果不计划使用此脚本，可以忽略对 FireEvent 方法的权限要求。

本机模式：

列出订阅：报表上的 ReportOperation 枚举（且用户是订阅所有者），或 ReadAnySubscription。
更改订阅：用户必须是 BUILTIN\Administrators 组的成员
列出子级：项上的 ReadProperties
触发事件：GenerateEvents（系统）

SharePoint 模式：

列出订阅：报表上的 ManageAlerts 或 CreateAlerts（且用户是订阅所有者、订阅是有时限的订阅）。
更改订阅：ManageWeb
列出子级：ViewListItems
触发事件：ManageWeb

有关详细信息，请参阅 Reporting Services 中的角色和任务与 SharePoint 组和权限的比较。

脚本使用情况

创建脚本文件 (.ps1)

创建一个名为 c:\scripts的文件夹。如果选择其他文件夹，请修改示例命令行语法语句中使用的文件夹名称。
为每个脚本创建文本文件并将文件保存至 c:\scripts 文件夹。创建 .ps1 文件时，请使用各个示例命令行语法中的名称。
使用管理权限打开命令提示符。
使用随各个示例提供的示例命令行语法，运行每个脚本文件。

经测试的环境

本文中的脚本已在 PowerShell 版本 3 上和以下版本的 Reporting Services 上进行了测试：

SQL Server 2014 (12.x)
SQL Server 2012 (11.x)
SQL Server 2008 R2 (10.50.x)

脚本：列出所有订阅的所有权

此脚本列出站点上的所有订阅。可以使用此脚本来测试连接，或验证在其他脚本中使用的报表路径和订阅 ID。此脚本也可用于审核存在哪些订阅以及它们的所有者是谁。

本机模式语法：

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

SharePoint 模式语法：

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

脚本：

# Parameters  
#    server   - server and instance name (e.g. myserver/reportserver or myserver/reportserver_db2)  
  
Param(  
    [string]$server,  
    [string]$site  
   )  
  
$rs2010 += New-WebServiceProxy -Uri "https://$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

提示

要在 SharePoint 模式下验证站点 URL，请使用 SharePoint cmdlet Get-SPSite。有关详细信息，请参阅 Get-SPSite。

脚本：列出特定用户拥有的全部订阅

此脚本列出特定用户拥有的全部订阅。可以使用此脚本来测试连接，或验证在其他脚本中使用的报表路径和订阅 ID。当有人离开你的组织，而你想要验证他们拥有哪些订阅时，此脚本非常有用。使用脚本，可以更改所有者或删除订阅。

本机模式语法：

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" "https://[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 "https://$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 "https://$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 的不同 SharePoint 模式。语法示例中使用的报表名称是“title only”，包含一个空格，因此报表名称两边需要带单引号。

本机模式语法：

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"  "'https://[server]/shared documents/title only.rdl'" "https://[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 "https://$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" "https://[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 "https://$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.config 配置文件。

脚本包括延迟逻辑“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" "https://[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 "https://$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}

通过

管理订阅所有者并运行订阅 - PowerShell

本文内容：

如何使用脚本

权限

脚本使用情况

脚本：列出所有订阅的所有权

脚本：列出特定用户拥有的全部订阅

脚本：更改特定用户拥有的全部订阅的所有权

脚本：列出与特定报表关联的全部订阅

脚本：更改特定订阅的所有权

脚本：运行（触发）单个订阅

反馈

其他资源

通过

管理订阅所有者并运行订阅 - PowerShell

本文内容：

如何使用脚本

权限

脚本使用情况

脚本：列出所有订阅的所有权

脚本：列出特定用户拥有的全部订阅

脚本：更改特定用户拥有的全部订阅的所有权

脚本：列出与特定报表关联的全部订阅

脚本：更改特定订阅的所有权

脚本：运行（触发）单个订阅

相关内容

反馈

其他资源