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 Application. службы Excel приложение всегда применяет свойства, определенные расположением доверенного файла, из которого была загружена книга. Чтобы определить, какие именно свойства надежного расположения будут использоваться, путь к файлу книги сравнивается с параметром Address расположения.

Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.

Примеры

--------------ПРИМЕР 1--------------

Get-SPExcelFileLocation -ExcelServiceApplication "My Excel Service" | where { $_.externaldataallowed -eq "DclAndEmbedded"} | Set-SPExcelFileLocation -ExernalDataAllowed Dcl

В этом примере возвращается каждое надежное расположение файла для приложения веб-службы службы Excel с именем "Моя служба Excel", которое позволяет загружать подключения к данным из файлов книги, и указывает, что расположения должны использовать библиотеку подключений к данным для загрузки подключений к данным.

--------------ПРИМЕР 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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-AssignmentCollection

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Type:SPAssignmentCollection
Position:Named
Default value:None
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
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-ConcurrentDataRequestsPerSessionMax

Specifies the maximum number of concurrent external data requests allowed in each session. If a session must issue more than this number of requests, additional requests must be queued. The scope of this setting is the logical server. The default value is 5.

Типом должно быть положительное целое число.

Type:Int32
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-DefaultWorkbookCalcMode

Режим вычисления для книг. Все параметры, кроме File, переопределяют параметры книг. Если этот параметр изменен, он применяется ко всем новым сеансам в приложении службы Excel при обновлении кэша свойств ConfigDB. По умолчанию используется значение File.

Типом должно быть одно из следующих значений: File, Manual, Auto или AutoDataTables.

Type:DefaultWorkbookCalcMode
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-Description

Указывает понятное описание нового расположения файлов.

Типом должна быть допустимая строка (например, "Расположение файлов ежемесячных отчетов о продажах").

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-DisplayGranularExtDataErrors

Отображает детализированные сообщения об ошибках при работе с внешними данными для файлов из этого расположения.

Type:SwitchParameter
Position:Named
Default value:None
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
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
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
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-адрес, указанный в адресе.

Type:SwitchParameter
Position:Named
Default value:None
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
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
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
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-RESTExternalDataAllowed

Указывает, разрешены ли запросы от интерфейса API REST для обновления подключений к внешним данным.

Параметр RESTExternalDataAllowed не действует, если параметр External DataAllowed имеет значение None.

Type:SwitchParameter
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-ShortSessionTimeout

Specifies the time, in seconds, that a user has to make the initial interaction with a spreadsheet. After this time has elapsed, if the user is not active, then the session is closed. The value must always be less than SessionTimeout. If the ShortSessionTimeout value is greater than or equal to SessionTimeout, an error is returned. The default value is 75.

Типом должно быть значение -1 или целое число от 1 до 2 073 600.

Type:Int32
Position:Named
Default value:None
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
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
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013