Set-SPExcelFileLocation

 

適用版本:SharePoint Server 2013 Enterprise

上次修改主題的時間:2015-03-09

設定 Excel Services 應用程式 信任之檔案位置的屬性。

Set-SPExcelFileLocation [-Identity] <SPExcelFileLocationPipeBind> -ExcelServiceApplication <SPExcelServiceApplicationPipeBind> [-AbortOnRefreshOnOpenFail <SwitchParameter>] [-Address <String>] [-AssignmentCollection <SPAssignmentCollection>] [-AutomaticVolatileFunctionCacheLifetime <Int32>] [-ChartAndImageSizeMax <Int32>] [-ChartRenderDurationMax <Int32>] [-ConcurrentDataRequestsPerSessionMax <Int32>] [-Confirm [<SwitchParameter>]] [-DefaultWorkbookCalcMode <File | Manual | Auto | AutoDataTables>] [-Description <String>] [-DisplayGranularExtDataErrors <SwitchParameter>] [-ExternalDataAllowed <None | Dcl | DclAndEmbedded>] [-IncludeChildren <SwitchParameter>] [-LocationType <SharePoint | Unc | Http>] [-ManualExtDataCacheLifetime <Int32>] [-NewWorkbookSessionTimeout <Int32>] [-PeriodicExtDataCacheLifetime <Int32>] [-RequestDurationMax <Int32>] [-RESTExternalDataAllowed <SwitchParameter>] [-SessionTimeout <Int32>] [-ShortSessionTimeout <Int32>] [-UdfsAllowed <SwitchParameter>] [-WarnOnDataRefresh <SwitchParameter>] [-WhatIf [<SwitchParameter>]] [-WorkbookSizeMax <Int32>]

Set-SPExcelFileLocation Cmdlet 會設定 Excel Services 應用程式 從該位置載入活頁簿之位置的屬性。Excel Services 應用程式 只會載入儲存在信任的檔案位置中的活頁簿。信任之檔案位置的屬性控制在 Excel Services 應用程式 中載入活頁簿時,如何使用這些活頁簿。Excel Services 應用程式 永遠會強制執行信任的檔案位置所定義的屬性,而活頁簿便是從該位置載入。信任的檔案位置所使用的屬性,會藉由比較活頁簿的檔案路徑和信任之檔案位置的 Address 參數來決定。

SharePoint 管理命令介面

 

參數 必要 類型 說明

Identity

必要

Microsoft.Office.Excel.Server.Cmdlet.SPExcelFileLocationPipeBind

這會指定要更新的 FileLocation 物件。該名稱在檔案位置清單中必須是唯一的。

其類型必須為有效的 GUID,且格式為 12345678-90ab-cdef-1234-567890bcdefgh;識別檔案位置的有效字串,且格式為 http://myPortal/myTeam;識別路徑的有效字串,且格式為 C:\folder_name;或是有效之 SPExcelFileLocation 物件的執行個體。

ExcelServiceApplication

必要

Microsoft.Office.Excel.Server.Cmdlet.SPExcelServiceApplicationPipeBind

這會指定包含 SPExcelFileLocation 清單物件的 Excel Services 應用程式 Web 服務應用程式。

其類型必須為有效的 GUID,且格式為 12345678-90ab-cdef-1234-567890bcdefgh;在伺服器陣列 (例如,MyExcelService1) 中,Excel Services 應用程式 Web 服務應用程式 的有效名稱;或是有效之 SPExcelServiceApplication 物件的執行個體。

AbortOnRefreshOnOpenFail

選用

System.Management.Automation.SwitchParameter

這會指定如果自動資料重新整理作業在檔案開啟時失敗,則 Excel Services 應用程式 檔案的載入會自動失敗。只有當下列條件成立時,載入作業才會失敗:

-- 使用者具有 Excel Services 應用程式 檔案的唯讀權限。

-- 當 Excel 檔案開啟時,活頁簿檔案具有自動重新整理的資料連線。

Address

選用

System.String

這會指定 Web 資料夾或檔案目錄,以供 Excel Services 應用程式 載入活頁簿。

其類型必須為有效的 URL,且格式為 http://myPortal/myTeam;或是有效的 UNC 路徑,且格式為 \\server_name\folder_name

AssignmentCollection

選用

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

為能適當處置物件而管理物件。使用 SPWebSPSite 等物件可能會耗用大量的記憶體,因此在 Windows PowerShell 指令碼中使用這些物件時,必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數,並在不需要時處置這些物件,以釋放記憶體。使用 SPWebSPSiteSPSiteAdministration 物件時,若未使用指派集合或 Global 參數,將會自動處置這些物件。

注意事項附註:
使用 Global 參數時,所有物件會包含在全域儲存區內。若未立即使用物件,或未使用 Stop-SPAssignment 命令處置物件,將會發生記憶體不足的狀況。

AutomaticVolatileFunctionCacheLifetime

選用

System.Int32

這會指定自動重算時,快取動態函數的計算值所需的時間上限 (以秒為單位)。有效值包括:

-1,活頁簿載入時計算一次

0,自動計算

12073600,快取 1 秒到 24 天

其類型必須是整數 -1 或 0,或是介於 1 到 2073600 的整數值。

ChartAndImageSizeMax

選用

System.Int32

這會指定可開啟之圖表或圖像的大小上限 (以 MB 為單位)。預設值為 1

其類型必須為大於 0 的有效整數。

ConcurrentDataRequestsPerSessionMax

選用

System.Int32

這會指定每個工作階段所允許的並行外部資料要求數目上限。如果工作階段必須發出超過此數目的要求,就必須進行佇列。此設定的範圍是邏輯伺服器。預設值為 5

此類型必須是正整數。

Confirm

選用

System.Management.Automation.SwitchParameter

執行命令之前,會先提示您進行確認。如需詳細資訊,請輸入下列命令:get-help about_commonparameters

DefaultWorkbookCalcMode

選用

Microsoft.Office.Excel.Server.DefaultWorkbookCalcMode

這會指定活頁簿的計算模式。除了 File 設定以外的所有設定都將覆寫活頁簿設定。如果變更此參數,重新整理 ConfigDB 屬性快取時,就會將變更套用到 Excel Services 應用程式 上的所有新工作階段。預設設定為 File

其類型必須為下列其中之一:FileManualAutoAutoDataTables

Description

選用

System.String

這會指定新檔案位置的易懂說明。

其類型必須為有效的字串;例如,這是月銷售報表的檔案位置。

DisplayGranularExtDataErrors

選用

System.Management.Automation.SwitchParameter

這會針對此位置的檔案,顯示外部資料失敗時的詳細錯誤訊息。

ExternalDataAllowed

選用

Microsoft.Office.Excel.Server.AllowExternalData

這會指定活頁簿允許的外部資料存取類型:None 會指定停用資料重新整理。Dcl 會指定只有在使用信任的資料連線庫中的連線檔案時,才重新整理資料。DclandEmbedded 會指定可以使用資料連線庫,但並非必要。此設定的範圍是信任的位置。

預設值為 None

其類型必須為下列其中之一:NoneDclDclAndEmbedded

IncludeChildren

選用

System.Management.Automation.SwitchParameter

這會指出信任的下層 URL、目錄及程式庫。例如,如果信任的檔案位置是 http://portal,且 IncludeChildren 為 True,則 http://portal/subSite 也會受到信任,還有其他在 Address 中指定之 URL 底下的任何 subURL 也將受到信任。

LocationType

選用

Microsoft.Office.Excel.Server.LocationType

位置的類型。LocationType 會指出 Excel Services 應用程式 如何從 Address 中指定的位置擷取檔案。預設值為 SharePoint

其類型必須為下列其中之一:SharePointUNCHTTP

ManualExtDataCacheLifetime

選用

System.Int32

這會指定時間 (以秒為單位),亦即 Excel Services 應用程式 會等候的時間,然後才重新發出手動或使用者啟始的外部資料要求。在這段期間內,可能會從外部資料快取,傳回來自先前外部資料要求的結果。

有效值如下:

-1,開始查詢後不再重新整理

1 到 2073600,快取 1 秒到 24 天。

預設值為 300

NewWorkbookSessionTimeout

選用

System.Int32

這會指定時間 (以秒為單位),亦即當使用者沒有活動後,Excel Services 應用程式 上未儲存之新活頁簿的工作階段保持使用中的時間。預設值為 1800。有效值包括:

-1,工作階段永遠不過期

0,工作階段會在處理完單一要求後過期

12073600,保持使用中 1 秒到 24 天。

其類型必須為 -1、0,或是介於 1 到 2073600 的整數。

PeriodicExtDataCacheLifetime

選用

System.Int32

這會指定時間 (以秒為單位),亦即 Excel Services 應用程式 會等候的時間,然後才重新發出開啟時定期 (也就是自動) 的外部資料要求。在這段期間內,可能會從外部資料快取,傳回來自先前外部資料要求的結果。-1 的值會指定開始查詢後不再重新整理。

其類型必須為 -1、0,或是介於 1 到 2073600 的整數。

預設值為 300

RequestDurationMax

選用

System.Int32

這會指定工作階段中單一要求的最長持續時間 (以秒為單位)。若超過這段時間,要求便會逾時。

其類型必須為 -1 (沒有限制),或是介於 1 到 2073600 的整數。

預設值為 300

RESTExternalDataAllowed

選用

System.Management.Automation.SwitchParameter

這會指定是否允許來自代表性狀態傳輸 (Representational State Transfer,REST) 應用程式開發介面 (API) 的要求重新整理外部資料連線。

如果 External DataAllowed 參數設定為 None,則 RESTExternalDataAllowed 參數沒有作用。

SessionTimeout

選用

System.Int32

這會指定時間 (以秒為單位),亦即當使用者沒有活動後,Excel Services 應用程式 上的工作階段保持使用中的時間。預設為 300 秒。預設值為 300。有效值包括:

-1,工作階段永遠不過期

0,工作階段會在處理完單一要求後過期

12073600,保持使用中 1 秒到 24 天

其類型必須為 -1、0,或是介於 1 到 2073600 的整數。

ShortSessionTimeout

選用

System.Int32

這會指定時間 (以秒為單位),亦即使用者必須與試算表進行初始互動的時間。如果經過這段時間,使用者仍未開始動作,工作階段便會結束。此值必須永遠小於 SessionTimeout。如果 ShortSessionTimeout 值大於或等於 SessionTimeout,則會傳回錯誤。預設值為 75

其類型必須為 -1,或是介於 1 到 2073600 的整數。

UdfsAllowed

選用

System.Management.Automation.SwitchParameter

這會指定從信任的檔案位置 (根據 Address 所指定) 載入之活頁簿,可以呼叫使用者定義的函數。

WarnOnDataRefresh

選用

System.Management.Automation.SwitchParameter

這會指定活頁簿資料第一次重新整理時,要向使用者顯示警告。預設值為 True

WhatIf

選用

System.Management.Automation.SwitchParameter

顯示訊息描述命令效果,而非描述命令執行的效果。如需詳細資訊,請輸入下列命令:get-help about_commonparameters

WorkbookSizeMax

選用

System.Int32

這會指定可載入之活頁簿的大小上限 (以 MB 為單位)。預設值為 10

其類型必須為整數值,且介於 1 到 2000 之間。

--------------範例 1--------------

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

此範例會取得允許從活頁簿檔案載入資料連線,且名為 My Excel Service 之 Excel Services 應用程式 Web 服務應用程式 的每一個信任檔案位置,並會指定位置必須使用資料連線庫來載入資料連線。

--------------範例 2--------------

Get-SPExcelServiceApplication | Get-SPExcelFileLocation | where {$_.Address -eq "http://"} | 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 Services 應用程式 Web 服務應用程式 的預設檔案位置說明。

顯示: