Поделиться через


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