New-SPExcelFileLocation

 

適用版本:SharePoint Server 2013 Enterprise

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

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

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) 載入活頁簿時,應用程式會使用來自子網站信任之位置的屬性,因為這個相符位址最長。

SharePoint 管理命令介面

 

參數 必要 類型 說明

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

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

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

AutomaticVolatileFunctionCacheLifetime

選用

System.Int32

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

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

0,自動計算。

12073600,快取 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

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

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,工作階段會在處理完單一要求後過期。

12073600,保持使用中 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,工作階段會在處理完單一要求後過期。

12073600,保持使用中 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 之間。

--------------範例 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 服務應用程式,將新的信任檔案位置新增到信任的檔案位置清單中,並加上指定位址與說明。

顯示: