Set-SPExcelFileLocation
Задает свойства надежного расположения файлов для приложения служб Excel.
Синтаксис
Set-SPExcelFileLocation
[-Identity] <SPExcelFileLocationPipeBind>
-ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
[-AbortOnRefreshOnOpenFail]
[-Address <String>]
[-AssignmentCollection <SPAssignmentCollection>]
[-AutomaticVolatileFunctionCacheLifetime <Int32>]
[-ChartAndImageSizeMax <Int32>]
[-ConcurrentDataRequestsPerSessionMax <Int32>]
[-Confirm]
[-DefaultWorkbookCalcMode <DefaultWorkbookCalcMode>]
[-Description <String>]
[-DisplayGranularExtDataErrors]
[-ExternalDataAllowed <AllowExternalData>]
[-IncludeChildren]
[-LocationType <LocationType>]
[-ManualExtDataCacheLifetime <Int32>]
[-NewWorkbookSessionTimeout <Int32>]
[-PeriodicExtDataCacheLifetime <Int32>]
[-RequestDurationMax <Int32>]
[-RESTExternalDataAllowed]
[-SessionTimeout <Int32>]
[-ShortSessionTimeout <Int32>]
[-UdfsAllowed]
[-WarnOnDataRefresh]
[-WhatIf]
[-WorkbookSizeMax <Int32>]
[-ChartRenderDurationMax <Int32>]
[<CommonParameters>]
Описание
Командлет Set-SPExcelFileLocation
задает свойства расположения, из которого службы Excel приложение загружает книги.
службы Excel приложение загружает только книги, хранящиеся в надежном расположении файлов.
Свойства надежных расположений файлов определяют, как можно использовать книги при их загрузке в службы Excel приложении.
службы Excel приложение всегда применяет свойства, определенные доверенным расположением файла, из которого была загружена книга.
Чтобы определить, какие именно свойства надежного расположения будут использоваться, путь к файлу книги сравнивается с параметром Address расположения.
Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.
Примеры
--------------ПРИМЕР 1--------------
Get-SPExcelFileLocation -ExcelServiceApplication "My Excel Service" | where { $_.externaldataallowed -eq "DclAndEmbedded"} | Set-SPExcelFileLocation -ExernalDataAllowed Dcl
В этом примере возвращается каждое надежное расположение файла для приложения веб-службы приложений службы Excel с именем My Excel Service, которое позволяет подключениям к данным загружаться из файлов книг и указывает, что для загрузки подключений к данным эти расположения должны использовать библиотеку подключений к данным.
--------------ПРИМЕР 2--------------
Get-SPExcelServiceApplication | Get-SPExcelFileLocation | where {$_.Address -eq "https://"} | Set-SPExcelFileLocation -Description "This is the default trusted file location for Excel Services Application. It allows any file from anywhere in SharePoint to load."
В этом примере изменяется описание расположения файла по умолчанию для каждого службы Excel приложения веб-службы приложения в ферме.
Параметры
-AbortOnRefreshOnOpenFail
Указывает, что загрузка файла приложения службы Excel автоматически завершается сбоем при сбое автоматического обновления данных при открытии файла. Ошибка загрузки возможна только при выполнении указанных ниже условий.
— Пользователь имеет разрешения только для чтения для файла приложения службы Excel. — Книга имеет подключение к данным, которое автоматически обновляется при открытии файла Excel.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-Address
System.String
Указывает веб-папку или каталог файлов, из которого службы Excel приложение может загружать книги.
Тип должен быть допустимым URL-адресом в форме https://myPortal/myTeam; или допустимым UNC-путем в форме , \\server_name\folder_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 |
-AutomaticVolatileFunctionCacheLifetime
Указывает наибольшее время кэширования вычисленного значения переменной функции для автоматического пересчета (сек.). Допускаются указанные ниже значения.
-1 Вычисление выполняется один раз при загрузке книги.
0 Вычисление выполняется всегда.
От 1 до 2 073 600 Кэширование выполняется на срок от 1 секунды до 24 дней.
Типом должно быть значение -1, 0 либо целое число от 1 до 2 073 600.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ChartAndImageSizeMax
Указывает наибольший размер диаграммы или изображения, при котором их можно открыть (МБ). Значение по умолчанию равно 1.
Типом должно быть допустимое целое число больше 0.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ChartRenderDurationMax
Максимальное время (в секундах), затраченное на отрисовку любой отдельной диаграммы.
Допустимые значения: -1 (без ограничения); от 1 до 2073600 (24 дня).
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ConcurrentDataRequestsPerSessionMax
Указывает наибольшее число одновременных запросов внешних данных, разрешенное для одного сеанса. При превышении этого значения дополнительные запросы помещаются в очередь. Областью действия этого параметра является логический сервер. Значение по умолчанию равно 5.
Типом должно быть положительное целое число.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
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 |
-DefaultWorkbookCalcMode
Режим вычисления для книг. Все параметры, кроме File, переопределяют параметры книг. Если этот параметр изменен, он применяется ко всем новым сеансам в службы Excel Application при обновлении кэша свойств ConfigDB. По умолчанию используется значение File.
Типом должно быть одно из следующих значений: File, Manual, Auto или AutoDataTables.
Type: | DefaultWorkbookCalcMode |
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 |
-DisplayGranularExtDataErrors
Отображает детализированные сообщения об ошибках при работе с внешними данными для файлов из этого расположения.
Type: | SwitchParameter |
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, содержащее объект списка SPExcelFileLocation.
Тип должен быть допустимым ИДЕНТИФИКАТОРом 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 |
-ExternalDataAllowed
Указывает тип доступа к внешним данным, разрешенный для книг. Значение None указывает, что обновление данных отключено. Dcl указывает, что данные обновляются только при использовании файла подключения в доверенной библиотеке подключений к данным. DclandEmbedded указывает, что можно использовать библиотеку подключения к данным, но она не является обязательной. Областью этого параметра является надежное расположение.
Значение по умолчанию: None.
Типом должно быть одно из следующих значений: None, Dcl или DclAndEmbedded.
Type: | AllowExternalData |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-Identity
Указывает объект FileLocation, который необходимо обновить. Это имя должно быть уникальным в списке расположений файлов.
Тип должен быть допустимым ИДЕНТИФИКАТОРом GUID в форме 12345678-90ab-cdef-1234-567890bcdefgh; Допустимая строка, идентифицируемая расположение файла в виде https://myPortal/myTeam; допустимая строка, идентифицирует путь в формате C:\folder_name; или экземпляр допустимого объекта SPExcelFileLocation.
Type: | SPExcelFileLocationPipeBind |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-IncludeChildren
Указывает, что дочерние URL-адреса, каталоги и библиотеки являются надежными. Например, если расположение доверенного файла — https://portal, а IncludeChildren — true, то https://portal/subSite также является доверенным, как и любой вложенный URL в URL-адресе, указанном в поле Адрес.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-LocationType
Тип расположения. LocationType указывает, как приложение службы Excel извлекает файлы из этого расположения, указанного в поле Адрес. Значение по умолчанию — SharePoint.
Типом должно быть одно из следующих значений: SharePoint, UNC или HTTP.
Type: | LocationType |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ManualExtDataCacheLifetime
Указывает время ожидания (в секундах), которое службы Excel приложение ожидает перед повторной выдачей вручную или инициированного пользователем запроса внешних данных. В течение этого времени результаты предыдущего запроса внешних данных могут быть возвращены из кэша внешних данных.
Допустимые значения:
-1 Никогда не обновляться после первого запроса
От 1 до 2073600 Кэш от 1 секунды до 24 дней.
Значение по умолчанию равно 300.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-NewWorkbookSessionTimeout
Указывает время (в секундах) того, что сеанс для новой несохраняемой книги будет оставаться активным в службы Excel приложении без активности пользователя. Значение по умолчанию — 1800. Допустимые значения:
-1, срок действия сеанса не истекает
0, срок действия сеанса истекает в конце одного запроса
От 1 до 2073600, остаются активными от 1 секунды до 24 дней.
Типом должно быть значение -1, 0 или целое число от 1 до 2 073 600.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-PeriodicExtDataCacheLifetime
Указывает время ожидания службы Excel приложением (в секундах) перед повторной отправкой открытого или периодического (то есть автоматического) запроса внешних данных. В течение этого времени результаты предыдущего запроса внешних данных могут быть возвращены из кэша внешних данных. Значение -1 отключает обновление после первого запроса.
Типом должно быть значение -1, 0 или целое число от 1 до 2 073 600.
Значение по умолчанию равно 300.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-RequestDurationMax
Указывает максимальную длительность одного запроса в сеансе (сек). В случае превышения этого значения время ожидания запроса истекает.
Типом должно быть значение -1 (без ограничений) или целое число от 1 до 2 073 600.
Значение по умолчанию равно 300.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-RESTExternalDataAllowed
Указывает, разрешены ли запросы от интерфейса API REST для обновления подключений к внешним данным.
Параметр RESTExternalDataAllowed не действует, если параметр External DataAllowed имеет значение Нет.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-SessionTimeout
Указывает время (в секундах) для того, чтобы сеанс оставался активным в службы Excel приложении без активности пользователя. По умолчанию используется значение 300 секунд. Значение по умолчанию равно 300. Допустимыми являются следующие значения:
-1Длительность сеанса не ограничивается.
0, срок действия сеанса истекает в конце одного запроса
От 1 до 2 073 600 Сеанс остается активным от 1 секунды до 24 дней.
Типом должно быть значение -1, 0 или целое число от 1 до 2 073 600.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ShortSessionTimeout
Указывает время, в течение которого пользователь должен начать работу с электронной таблицей (сек.). По истечении этого времени при отсутствии действий со стороны пользователя сеанс закрывается. Это значение всегда должно быть меньше значения параметра SessionTimeout. Если значение ShortSessionTimeout больше значения SessionTimeoutили равно ему, возвращается ошибка. Значение по умолчанию — 75.
Типом должно быть значение -1 или целое число от 1 до 2 073 600.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-UdfsAllowed
Указывает, что пользовательские функции могут вызываться книгами, загруженными из надежного расположения файлов, указанного с помощью параметра Address.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-WarnOnDataRefresh
Указывает, что при первом обновлении данных для книги выводится предупреждение. Значение по умолчанию — True.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
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 |
-WorkbookSizeMax
Указывает наибольший размер книги, при котором ее можно загрузить (МБ). Значение по умолчанию — 10.
Типом должно быть целое число от 1 до 2000.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по