New-SPExcelFileLocation

發行項
11/25/2016

適用版本： SharePoint Server 2010

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

這會將新的信任位置新增到 Excel Services 應用程式。

Syntax

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

詳細說明

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

長度最長的相符項目優先。例如，如果 http://portal/site/ 和 http://portal/site/subsite 都是信任的位置，當您從子網站 (Subsite) 載入活頁簿時，應用程式會使用來自子網站信任之位置的屬性，因為這個相符位址最長。

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

Parameters

參數	必要	類型	描述
Address	必要	System.String	這會指定 Web 資料夾或檔案目錄，以供 Excel Services 應用程式載入活頁簿。其類型必須為有效的 URL，且格式為 http://myPortal/myTeam；或是有效的 UNC 路徑，且格式為 \\server_name\folder_name
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 應用程式檔案的載入會自動失敗。只有當下列條件成立時，載入作業才會失敗： - 使用者具有檔案的 SharePoint Product and Technologies 唯讀權限。 - 當 Excel Services 應用程式檔案開啟時，活頁簿檔案具有自動重新整理的資料連線。
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 天。預設整數值為 300。其類型必須為整數 -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 以外的設定會覆寫活頁簿設定。預設設定為 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 底下的任何 URL 下層也將受到信任。
LocationType	選用	Microsoft.Office.Excel.Server.LocationType	這會指定位置的類型。位置類型會指出 Excel Services 應用程式如何從 Address 中指定的位置擷取檔案。預設設定為 SharePoint 類型。預設值為 SharePoint。其類型必須為下列其中之一：SharePoint、UNC 或 HTTP。
ManualExtDataCacheLifetime	選用	System.Int32	這會指定時間 (以秒為單位)，亦即 Excel Services 應用程式會等候的時間，然後才重新發出手動或使用者啟始的外部資料要求。在這段期間內，可能會從外部資料快取，傳回來自先前外部資料要求的結果。預設值為 300。有效值為下列任一個項目： -1，開始查詢後不再重新整理。1 到 2073600，快取 1 秒到 24 天。
NewWorkbookSessionTimeout	選用	System.Int32	這會指定時間 (以秒為單位)，亦即當使用者沒有活動後，Excel Services 應用程式上未儲存之新活頁簿的工作階段保持使用中的時間。有效值包括： -1，工作階段永遠不過期。 0，工作階段會在處理完單一要求後過期。 1 到 2073600，保持使用中 1 秒到 24 天。預設值為 1800。其類型必須為 -1、0，或是介於 1 到 2073600 的整數。
PeriodicExtDataCacheLifetime	選用	System.Int32	這會指定時間 (以秒為單位)，亦即 Excel Services 應用程式會等候的時間，然後才重新發出開啟時或定期 (也就是自動) 的外部資料要求。在這段期間內，可能會從外部資料快取，傳回來自先前外部資料要求的結果。-1 的值會指定開始查詢後不再重新整理。預設值為 300。其類型必須為 -1、0，或是介於 1 到 2073600 的整數。
RequestDurationMax	選用	System.Int32	這會指定工作階段中單一要求的最長持續時間 (以秒為單位)。若超過這段時間，則要求逾時。預設值為 300。其類型必須為 -1 (沒有限制)，或是介於 1 到 2073600 的整數。
RESTExternalDataAllowed	選用	System.Management.Automation.SwitchParameter	這會指定是否允許來自代表性狀態傳輸 (Representational State Transfer，REST) 應用程式開發介面 (API) 的要求重新整理外部資料連線。如果 ExternalDataAllowed 參數設定為 None，則 RESTExternalDataAllowed 參數沒有作用。
SessionTimeout	選用	System.Int32	這會指定時間 (以秒為單位)，亦即當使用者沒有活動後，Excel Services 應用程式上的工作階段保持使用中的時間。有效值包括： -1，工作階段永遠不過期。 0，工作階段會在處理完單一要求後過期。 1 到 2073600，保持使用中 1 秒到 24 天。預設值為 300。其類型必須為 -1、0，或是介於 1 到 2073600 的整數。
ShortSessionTimeout	選用	System.Int32	這會指定時間 (以秒為單位)，亦即使用者必須與試算表進行初始互動的時間。如果經過這段時間，使用者仍未開始動作，工作階段便會結束。此值必須永遠小於 SessionTimeout。如果 ShortSessionTimeout 值大於或等於 SessionTimeout，則會傳回錯誤。預設值為 75。其類型必須為 -1，或是介於 1 到 2073600 的整數。
UdfsAllowed	選用	System.Management.Automation.SwitchParameter	這會指定從信任的檔案位置 (根據 Address 所指定) 載入之活頁簿，可以呼叫使用者定義的函數。預設值為 False。
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-SPExcelServiceApplication -identity "MyExcelService" | New-SPExcelFileLocation -address "http://myPortal/myTeam" -includechildren -locationType SharePoint -description "This is my team's site on myPortal." -workbooksizemax 50 -externaldataallowed DclAndEmbedded -WarnOnDataRefresh:$false

此範例會針對名為 MyExcelService 的 Excel Services 應用程式 Web 服務應用程式，將新的信任檔案位置新增到信任的檔案位置清單中。

此範例讓活頁簿可以從開頭為 http://myPortal/myTeam 的子項或子資料夾載入。從這個位置載入的所有活頁簿大小必須小於 50 MB。這些活頁簿可以透過使用內嵌在活頁簿檔案中或存放在資料連線庫中的連線，來重新整理外部資料。而且將不會顯示活頁簿嘗試重新整理外部資料的警告訊息。

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

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

此範例會針對名為 MyExcelService 的 Excel Services 應用程式 Web 服務應用程式，將新的信任檔案位置新增到信任的檔案位置清單中，並加上指定位址與說明。