New-SPExcelDataProvider

Ссылка

Модуль:: SharePointServer

Применяется к:: SharePoint Server 2010, SharePoint Server 2013

Добавляет нового безопасного поставщика данных в приложение служб 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