New-SPExcelDataConnectionLibrary
Добавляет новую библиотеку подключений к данным в приложение служб Excel.
Синтаксис
New-SPExcelDataConnectionLibrary
-Address <String>
-ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Description <String>]
[-WhatIf]
[<CommonParameters>]
Описание
Командлет New-SPExcelDataConnectionLibrary
добавляет библиотеку подключения к данным в список доверенных библиотек подключения к данным для приложения веб-службы приложений службы Excel.
приложение службы Excel загружает только файлы подключения к данным, хранящиеся в библиотеке подключений к данным, которая входит в список доверенных библиотек подключений к данным.
Библиотеки подключения к данным содержат файлы подключения к данным, которые содержат все ресурсы, необходимые службы Excel приложению и клиенту Excel для подключения к внешнему источнику данных.
Библиотеки подключений к данным позволяют повторно использовать подключения и предоставлять к ним общий доступ.
Для загрузки подключений к данным можно использовать сведения из файлов книг, однако их загрузка из библиотек позволяет управлять подключениями отдельно от книг.
Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.
Примеры
------------------ПРИМЕР------------------
$sa = Get-SPExcelServiceApplication
New-SPExcelDataConnectionLibrary -Address "https://portal/site/salesDCL" -Description "This is the DCL where all the connections to the sales data are stored." -ExcelServiceApplication $sa
В этом примере добавляется новая библиотека подключения к данным (DCL), а затем задается ее описание в список доверенных библиотек подключений к данным, который находится в приложении веб-службы приложений службы Excel с именем MyExcelService.
Книги могут использовать файлы подключения, хранящиеся в этой библиотеке, для обновления данных в приложении веб-службы службы Excel приложения.
Параметры
-Address
Указывает адрес библиотеки подключений к данным. Адрес должен быть уникальным в списке надежных библиотек подключений к данным.
Тип должен быть допустимым URL-адресом в форме https://server_name.
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 |
-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, содержащее объект списка SPExcelDataConnectionLibrary.
Тип должен быть допустимым ИДЕНТИФИКАТОРом 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 |
-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 |