Set-SPExcelDataConnectionLibrary
Задает свойства библиотеки подключений к данным для приложения служб Excel.
Синтаксис
Set-SPExcelDataConnectionLibrary
[-Identity] <SPExcelDCLPipeBind>
-ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
[-Address <String>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Description <String>]
[-WhatIf]
[<CommonParameters>]
Описание
Командлет Set-SPExcelDataConnectionLibrary
задает свойства библиотеки, из которой службы Excel Приложение загружает файлы подключения к данным.
службы Excel приложение загружает файлы подключения к данным, только если они хранятся в библиотеке подключений к данным, которая входит в список доверенных библиотек подключения к данным.
Библиотеки подключения к данным представляют собой своего рода список, содержащий файлы подключения к данным.
Эти файлы содержат все, что требуется службы Excel приложению и клиенту Excel для подключения к внешнему источнику данных.
Библиотеки подключений к данным позволяют повторно использовать подключения и предоставлять к ним общий доступ.
Подключения к данным можно загрузить с помощью сведений из файла книги.
Однако использование библиотеки подключений к данным для загрузки подключений к данным предоставляет дополнительный уровень для подключений к данным, что позволяет управлять ими отдельно от книг.
Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.
Примеры
--------------ПРИМЕР 1--------------
Get-SPExcelServiceApplication -Identity "MyExcelService" | Get-SPExcelDataConnectionLibrary | where {$_.address -eq "https://portal/site/salesDCL" } | Set-SPExcelDataConnectionLibrary -Description "This is the DCL where all the connections to the sales data are stored
В этом примере задается отображаемое описание для записи https://portal/site/salesDCL в списке доверенных библиотек подключения к данным (DCLs), которая находится в приложении веб-службы приложений службы Excel с именем MyExcelService.
--------------ПРИМЕР 2--------------
Get-SPExcelServiceApplication -Identity "MyExcelService" | Get-SPExcelDataConnectionLibrary | where {$_.address -eq "https://portal/site/salesDCL" } | Set-SPExcelDataConnectionLibrary -Address "https://portal/site/salesDCL
В этом примере обновляется адрес библиотеки подключения к данным для записи https://portal/test/site/salesDCLhttps://portal/site/salesDCL в списке доверенных библиотек подключения к данным, который находится в приложении веб-службы приложений службы Excel с именем MyExcelService.
Параметры
-Address
Указывает адрес библиотеки подключений к данным. Адрес должен быть уникальным в списке надежных библиотек подключений к данным.
Тип должен быть допустимым URL-адресом в форме https://server_name.
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 |
-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
Указывает понятное описание библиотеки подключений к данным.
Тип значения: допустимая строка (например, "Библиотека подключений к данным, в которой хранятся все подключения к данным о продажах").
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 |
-Identity
Указывает объект DataConnectionLibrary, который необходимо обновить.
Тип должен быть допустимым ИДЕНТИФИКАТОРом GUID в форме 12345678-90ab-cdef-1234-567890bcdefgh; допустимое имя библиотеки подключений к данным (например, DataConnectionLib1); допустимый URL-адрес в формате https://server_name; или экземпляр допустимого объекта SPExcelDCL.
Type: | SPExcelDCLPipeBind |
Position: | 1 |
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 |