New-SPExcelDataProvider
适用于: SharePoint Server 2010
上一次修改主题: 2015-03-09
向 Excel Services 应用程序 添加新安全数据提供程序。
Syntax
New-SPExcelDataProvider -ExcelServiceApplication <SPExcelServiceApplicationPipeBind> -ProviderId <String> -ProviderType <Oledb | Odbc | OdbcDsn> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-WhatIf [<SwitchParameter>]]
详细说明
New-SPExcelDataProvider cmdlet 向 Excel Services 应用程序 Web 服务应用程序 中的安全数据提供程序列表中添加数据提供程序。仅当外部数据连接的数据提供程序位于安全数据提供程序列表中时,Excel Services 应用程序 才刷新外部数据连接。Excel Services 应用程序 在此列表中包括一组常见的数据提供程序。因此,通常仅在自定义数据连接方案中才使用 cmdlet 修改安全数据提供程序。
有关此 cmdlet 的权限和最新信息,请参阅联机文档 (https://go.microsoft.com/fwlink/?LinkId=163185)。
Parameters
参数 | 是否必需 | 类型 | 说明 |
---|---|---|---|
ExcelServiceApplication |
必需 |
Microsoft.Office.Excel.Server.Cmdlet.SPExcelServiceApplicationPipeBind |
指定包含 SPExcelDataProvider 列表对象的 Excel Services 应用程序 Web 服务应用程序。 键入的值必须是 12345678-90ab-cdef-1234-567890bcdefgh 形式的有效 GUID;服务器场中 Excel Services 应用程序 Web 服务应用程序 的有效名称(例如 MyExcelService1);或有效 SPExcelServiceApplication 对象的实例。 |
ProviderId |
必需 |
System.String |
指定提供程序的名称。此 ID 应该出现在由此提供程序生成的连接字符串中,并且 ID 对于提供程序类型而言必须是唯一的。 键入的值必须是提供程序的有效名称,例如,CustomOLEDB。 |
ProviderType |
必需 |
Microsoft.Office.Excel.Server.DataProviderType |
指定要添加到安全提供程序列表中的受支持的数据提供程序类型。 键入的值必须为以下项之一:OleDb、Odbc 或 OdbcDsn。 |
AssignmentCollection |
可选 |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
管理对象以便正确进行处理。使用 SPWeb 或 SPSite 等对象可能会耗用大量内存,而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象,可以将对象分配给变量,然后在不需要这些对象时对它们进行处理,以释放内存。在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时,如果不使用分配集合或 Global 参数,则会自动处理这些对象。 备注 在使用 Global 参数时,所有对象均包含在全局存储中。如果未立即使用对象,或未通过使用 Stop-SPAssignment 命令来处理对象,则可能会发生内存不足的情况。 |
Confirm |
可选 |
System.Management.Automation.SwitchParameter |
在执行命令之前提示您确认。有关详细信息,请键入以下命令:get-help about_commonparameters |
Description |
可选 |
System.String |
指定新数据提供程序的友好说明。 键入的值必须是有效的字符串;例如,“这是自定义 OLEDB 提供程序”。 |
WhatIf |
可选 |
System.Management.Automation.SwitchParameter |
显示一条描述命令作用的消息,而不执行命令。有关详细信息,请键入以下命令:get-help about_commonparameters |
输入类型
返回类型
Example
--------------示例 1--------------
Get-SPExcelServiceApplication -identity "MyExcelService" | New-SPExcelDataProvider -providerID "CustomOLEDB" -ProviderType OleDb -description "This is a custom OLEDB provider"
此示例向名为 MyExcelService
的 Excel Services 应用程序 Web 服务应用程序 的安全数据提供程序列表中添加新的自定义 OLEDB 数据提供程序。
--------------示例 2--------------
Get-SPExcelServiceApplication | New-SPExcelDataProvider -providerID "CustomOLEDB" -ProviderType OleDb -description "This is a custom OLEDB provider"
此示例为服务器场中的所有 Excel Services 应用程序 Web 服务应用程序 向安全数据提供程序列表中添加新的自定义 OLEDB 数据提供程序。
See Also
Reference
Get-SPExcelDataProvider
Remove-SPExcelDataProvider
Set-SPExcelDataProvider