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


New-SPExcelFileLocation

Добавляет новое надежное расположение в приложение служб Excel.

Синтаксис

New-SPExcelFileLocation
   -Address <String>
   -ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
   [-AbortOnRefreshOnOpenFail]
   [-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>]

Описание

Командлет New-SPExcelFileLocation добавляет новое расположение в список надежных расположений файлов в приложении веб-службы приложений службы Excel. службы Excel приложение загружает только книги, хранящиеся в надежном расположении файлов. Свойства надежных расположений файлов определяют, как можно использовать книги при загрузке в службы Excel приложении. службы Excel приложение всегда применяет свойства, определенные расположением доверенного файла, из которого была загружена книга. Свойства, которые используются в надежном расположении файла, определяются путем сравнения пути к файлу книги с параметром Address расположения доверенного файла.

Самый длинный матч имеет приоритет. Например, если https://portal/site/ и https://portal/site/subsite являются доверенными расположениями и вы загружаете книгу с дочернего сайта, приложение использует свойства из доверенного расположения дочернего сайта, так как оно имеет самый длинный совпадающий адрес.

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

Примеры

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

Get-SPExcelServiceApplication -identity "MyExcelService" | New-SPExcelFileLocation -address "https://myPortal/myTeam" -includechildren -locationType SharePoint -description "This is my team's site on myPortal." -workbooksizemax 50 -externaldataallowed DclAndEmbedded -WarnOnDataRefresh:$false

В этом примере в список надежных расположений файлов добавляется новое надежное расположение файлов, которое находится в приложении веб-службы приложений службы Excel с именем MyExcelService.

В этом примере книги могут загружаться из любой дочерней или вложенной папки, которая начинается с https://myPortal/myTeam. Размер всех книг, загруженных из этого расположения, должен быть меньше 50 мегабайт (МБ). Книги могут обновлять внешние данные с помощью подключений, внедренных в файл книги или хранящихся в библиотеке подключений к данным. Предупреждение о том, что книга пытается обновить внешние данные, не будет отображаться.

------------------ПРИМЕР 2------------------

Get-SPExcelServiceApplication -identity "MyExcelService" | New-SPExcelFileLocation -address https://myPortal/myTeam/managers -locationType SharePoint -description "This is the manager's subsite for myTeam."

В этом примере в список надежных расположений файлов добавляется новое надежное расположение файлов, которое находится в приложении веб-службы приложений службы Excel с именем MyExcelService с заданным адресом и описанием.

Параметры

-AbortOnRefreshOnOpenFail

Указывает, что загрузка файла приложения службы Excel автоматически завершается сбоем при сбое автоматической операции обновления данных при открытии файла. Ошибка загрузки возможна только при выполнении указанных ниже условий.

  • У пользователя есть разрешения на доступ к файлу только для чтения продуктов и технологий SharePoint.
  • Файл книги имеет подключения к данным, которые обновляются автоматически при открытии файла приложения службы 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

Указывает веб-папку или каталог файлов, из которого службы Excel приложение может загружать книги.

Тип должен быть допустимым URL-адресом в форме https://myPortal/myTeam; или допустимым UNC-путем в форме , \\server_name\folder_name

Type:String
Position:Named
Default value:None
Required:True
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 до 2073600 Кэш от 1 секунды до 24 дней. По умолчанию целое число равно 300.

Типом должно быть значение -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

{{Fill ChartRenderDurationMax Description}}

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, переопределяют параметры книги. По умолчанию используется значение 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.

Тип должен иметь любой из следующих параметров:

Нет

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

-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

Указывает тип расположения. Тип расположения указывает, как приложение службы Excel извлекает файлы из расположения, указанного в поле Адрес. По умолчанию используется тип SharePoint. Значение по умолчанию — 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 приложением (в секундах) перед повторной отправкой вручную или инициированного пользователем запроса на внешние данные. В течение этого периода времени результаты предыдущего запроса внешних данных могут быть возвращены из внешнего кэша данных. Значение по умолчанию равно 300.

Допустимые значения — это любой из следующих элементов:

-1 Никогда не обновляется после первого запроса.1 до 2073600— кэширует от 1 секунды до 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

-NewWorkbookSessionTimeout

Указывает время (в секундах) того, что сеанс для новой несохраняемой книги остается активным в приложении службы Excel без активности пользователя. Допустимые значения:

-1 Срок действия сеанса не истекает.

0 Срок действия сеанса истекает в конце одного запроса.

От 1 до 2073600 остается активным от 1 секунды до 24 дней. Значение по умолчанию — 1800.

Типом должно быть значение -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 указывает, что никогда не обновляться после первого запроса. Значение по умолчанию равно 300.

Тип должен быть -1, 0 или целое число в диапазоне от 1 до 2073600.

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

Указывает максимальную длительность одного запроса в сеансе (сек). По истечении этого времени время ожидания запроса истекает. Значение по умолчанию — 300.

Типом должно быть значение -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

-RESTExternalDataAllowed

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

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 без активности пользователя. Допустимые значения:

-1 Срок действия сеанса не истекает.

В конце одного запроса истекает срок действия 0 сеанса.

От 1 до 2073600 остается активным от 1 секунды до 24 дней. Значение по умолчанию равно 300.

Типом должно быть значение -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

Указывает, что определяемые пользователем функции могут вызываться книгами, загруженными из надежного расположения файла, указанного в поле Адрес.

Значение по умолчанию — False.

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