Set-SPExcelFileLocation

發行項
11/25/2016

適用版本： SharePoint Server 2010

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

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

Syntax

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 參數來決定。

如需此 Cmdlet 的權限及最新資訊，請參閱線上文件 (https://go.microsoft.com/fwlink/?LinkId=163185)。

Parameters

參數	必要	類型	描述
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 應用程式檔案的 Windows SharePoint 唯讀權限。 -- 當 Excel 檔案開啟時，活頁簿檔案具有自動重新整理的資料連線。
Address	選用		System.String 這會指定 Web 資料夾或檔案目錄，以供 Excel Services 應用程式載入活頁簿。其類型必須為有效的 URL，且格式為 http://myPortal/myTeam；或是有效的 UNC 路徑，且格式為 \\server_name\folder_name
AssignmentCollection	選用	Microsoft.SharePoint.PowerShell.SPAssignmentCollection	為能適當處置物件而管理物件。使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。注意使用 Global 參數時，所有物件會包含在全域儲存區內。若未立即使用物件，或未使用 Stop-SPAssignment 命令處置物件，將會發生記憶體不足的狀況。
AutomaticVolatileFunctionCacheLifetime	選用	System.Int32	這會指定自動重算時，快取動態函數的計算值所需的時間上限 (以秒為單位)。有效值包括： -1，活頁簿載入時計算一次 0，自動計算 1 到 2073600，快取 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。其類型必須為下列其中之一：File、Manual、Auto 或 AutoDataTables。
Description	選用	System.String	這會指定新檔案位置的易懂說明。其類型必須為有效的字串；例如，這是月銷售報表的檔案位置。
DisplayGranularExtDataErrors	選用	System.Management.Automation.SwitchParameter	這會針對此位置的檔案，顯示外部資料失敗時的詳細錯誤訊息。
ExternalDataAllowed	選用	Microsoft.Office.Excel.Server.AllowExternalData	這會指定活頁簿允許的外部資料存取類型：None 會指定停用資料重新整理。Dcl 會指定只有在使用信任的資料連線庫中的連線檔案時，才重新整理資料。DclandEmbedded 會指定可以使用資料連線庫，但並非必要。此設定的範圍是信任的位置。預設值為 None。其類型必須為下列其中之一：None、Dcl 或 DclAndEmbedded。
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。其類型必須為下列其中之一：SharePoint、UNC 或 HTTP。
ManualExtDataCacheLifetime	選用	System.Int32	這會指定時間 (以秒為單位)，亦即 Excel Services 應用程式會等候的時間，然後才重新發出手動或使用者啟始的外部資料要求。在這段期間內，可能會從外部資料快取，傳回來自先前外部資料要求的結果。有效值如下： -1，開始查詢後不再重新整理 1 到 2073600，快取 1 秒到 24 天。預設值為 300。
NewWorkbookSessionTimeout	選用	System.Int32	這會指定時間 (以秒為單位)，亦即當使用者沒有活動後，Excel Services 應用程式上未儲存之新活頁簿的工作階段保持使用中的時間。預設值為 1800。有效值包括： -1，工作階段永遠不過期 0，工作階段會在處理完單一要求後過期 1 到 2073600，保持使用中 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，工作階段會在處理完單一要求後過期 1 到 2073600，保持使用中 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 之間。

輸入類型

傳回類型

Example

--------------範例 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 服務應用程式的預設檔案位置說明。