使用 Windows PowerShell 管理 Excel Services

 

适用于: Excel Services (SharePoint 2010), SharePoint Server 2010

上一次修改主题: 2010-07-26

本主题高度概述了用于 Microsoft SharePoint Server 2010 中的 Excel Services 的 Windows PowerShell 的行为。Excel Services 管理员可使用 Windows PowerShell 充分地对 Excel Services 安装和部署及配置选项执行脚本,在运行时配置所有设置以作为 Microsoft SharePoint Server 2010 部署的一部分。Excel Services 中的 Windows PowerShell 所遵循的命名约定、样式和行为准则与其他服务应用程序使用的准则相同。SharePoint Server 提供的 Windows PowerShell 命令行可用于执行 Excel Services 的管理操作。

用于 Excel Services 的 Windows PowerShell

用户必须是全局管理员角色的成员并且同时是本地管理员,才能在计算机上运行任何 Windows PowerShell 命令 (cmdlet)。通常,所有 Windows PowerShell cmdlet 均可控制内存中的对象,并且 Set cmdlet 会将属性值写入服务的 configdb 数据存储中。

警告

Excel Services 不支持 stsadm 命令。如果使用任何 stsadm 命令,则该命令会失败,并在命令提示符处返回一条错误消息。

Excel Services 和 Windows PowerShell cmdlet 均支持常规 Windows PowerShell 命令。管理员可以通过管道输入命令,获取每个命令的帮助,使用命令的别名,筛选结果,允许使用 whatif 参数并确认,以及在命令中使用变量和参数。有关 Windows PowerShell 命令的详细信息,请参阅 Excel Services cmdlet (SharePoint Server 2010)

用于 Excel Services 的示例 cmdlet

本节介绍如何打开 SharePoint 2010 Management Shell,以针对 Excel Services 执行任何 Excel Services 示例 cmdlet。

打开 SharePoint 2010 Management Shell

  1. 验证您是否满足以下最低要求:请参阅 Add-SPShellAdmin

  2. 在“开始”菜单上,单击“所有程序”。

  3. 单击“Microsoft SharePoint 2010 产品”。

  4. 单击“SharePoint 2010 Management Shell”。

  5. 在 Windows PowerShell 命令提示符 (PS C:\>) 处,键入以下任意示例命令,然后按 Enter:

  • 设置名为“MyExcelServer”的新 Excel Services 应用程序
    New-SPExcelServiceApplication -Name "MyExcelServer"

  • 针对服务器场中运行 Excel Services 实例的所有远程计算机,将每个用户的最大会话数更改为 100:
    Get-SPExcelServiceApplication | Set-SPExcelServiceApplication -SessionsPerUserMax 100

  • 对于 MyExcelServer,获取所有受信任的位置,而对于允许从工作簿加载数据的那些应用程序,则强制它们只使用文档连接库 (DCL)
    Get-SPExcelServiceApplication -Identity "MyExcelServer" | Get-SPExcelFileLocation | where {$_.ExternalDataAllowed -eq "DclAndEmbedded" } | Set-SPExcelFileLocation -ExternalDataAllowed Dcl

  • 允许 Web 部件、网页或 Web 服务跨域访问受信任文件位置中的工作簿(和受信任数据连接库中的数据连接),运行 Windows PowerShell cmdlet。以下命令示例对您的 SharePoint Server 服务器场中的所有 Excel Service 应用程序均有效:
    设置为 True:
    Get-SPExcelServiceApplication | Set-SPExcelServiceApplication -CrossDomainAccessAllowed
    设置为 False:
    Get-SPExcelServiceApplication | Set-SPExcelServiceApplication -CrossDomainAccessAllowed:$false
    验证:
    (Get-SPExcelServiceApplication).CrossDomainAccessAllowed