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


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