New-SPExcelDataProvider
Добавляет нового безопасного поставщика данных в приложение служб Excel.
Синтаксис
New-SPExcelDataProvider
-ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
-ProviderId <String>
-ProviderType <DataProviderType>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Description <String>]
[-WhatIf]
[<CommonParameters>]
Описание
Командлет New-SPExcelDataProvider
добавляет поставщика данных в список безопасных поставщиков данных в приложении веб-службы приложений службы Excel.
службы Excel приложение обновляет подключения к внешним данным, только если поставщик данных для подключения входит в список безопасных поставщиков данных.
службы Excel приложение включает набор общих поставщиков данных в этом списке.
Поэтому использование командлетов для изменения безопасных поставщиков данных обычно происходит только в пользовательских сценариях подключения к данным.
Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.
Примеры
------------------ПРИМЕР 1------------------
Get-SPExcelServiceApplication -identity "MyExcelService" | New-SPExcelDataProvider -providerID "CustomOLEDB" -ProviderType OleDb -description "This is a custom OLEDB provider"
В этом примере новый пользовательский поставщик данных OLEDB добавляется в список безопасных поставщиков данных для приложения веб-службы приложений службы Excel с именем MyExcelService.
------------------ПРИМЕР 2------------------
Get-SPExcelServiceApplication | New-SPExcelDataProvider -providerID "CustomOLEDB" -ProviderType OleDb -description "This is a custom OLEDB provider"
В этом примере новый пользовательский поставщик данных OLEDB добавляется в список надежных поставщиков данных для всех службы Excel приложения веб-службы приложений в ферме.
Параметры
-AssignmentCollection
Позволяет корректно удалять объекты. При использовании объектов таких типов, как SPWeb или SPSite, возможен захват больших объемов памяти, и работа с такими объектами в скриптах Windows PowerShell требует точного управления памятью. С помощью объекта SPAssignment вы можете назначить объекты переменной и освободить память, удалив ненужные объекты. Объекты SPWeb, SPSite или SPSiteAdministration после использования удаляются автоматически, если коллекция назначения или параметр Global не применяются.
При использовании параметра Global все объекты содержатся в глобальном хранилище.
Если объекты не используются сразу или удаляются с помощью команды Stop-SPAssignment
, может возникнуть нехватка памяти.
Type: | SPAssignmentCollection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-Confirm
Предлагает подтвердить выполнение команды.
Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-Description
Указывает понятное описание нового поставщика данных.
Тип значения: допустимая строка, например "Настраиваемый поставщик OLEDB".
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ExcelServiceApplication
Указывает приложение веб-службы приложения службы Excel, содержащее объект списка SPExcelDataProvider.
Тип должен быть допустимым ИДЕНТИФИКАТОРом GUID в форме 12345678-90ab-cdef-1234-567890bcdefgh; допустимое имя приложения веб-службы приложения службы Excel в ферме (например, MyExcelService1) или экземпляр допустимого объекта SPExcelServiceApplication.
Type: | SPExcelServiceApplicationPipeBind |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ProviderId
Указывает имя поставщика. Этот идентификатор должен присутствовать в строках подключений, создаваемых поставщиком, и быть уникальным для типа поставщика.
Типом должно быть допустимое имя поставщика (например, CustomOLEDB).
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ProviderType
Указывает поддерживаемый тип поставщика данных, который будет добавлен в список безопасных поставщиков.
Типом должно быть одно из следующих значений: OleDb, Odbc или OdbcDsn.
Type: | DataProviderType |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-WhatIf
Отображает описание команды. При этом сама команда не выполняется.
Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |