Set-SPExcelFileLocation

參考

模組:: SharePointServer

適用於:: SharePoint Server 2010, SharePoint Server 2013

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

Syntax

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

Description

Set-SPExcelFileLocation Cmdlet 會設定 Excel Services 應用程式載入活頁簿的位置屬性。 Excel Services 應用程式只會載入儲存在受信任檔案位置的活頁簿。受信任檔案位置的屬性可控制在 Excel Services 應用程式載入時使用活頁簿的方式。 Excel Services 應用程式一直強制執行由載入活頁簿之受信任檔案位置所定義的屬性。受信任檔案位置所使用的屬性是透過比較活頁簿的檔案路徑與受信任檔案位置的 Address 參數來判斷。

如需 SharePoint 產品和技術的 Windows PowerShell 權限及最新資訊，請參閱線上文件 SharePoint Server Cmdlet。

範例

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

參數

-AbortOnRefreshOnOpenFail

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

-- 使用者具有 Excel Services 應用程式檔案的唯讀權限。 -- 當 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

System.String

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

此類型必須是格式為的有效 URL， https://myPortal/myTeam 或表單中的有效 UNC 路徑 \\server_name\folder_name

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

-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 天

其類型必須是整數 -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

-ChartAndImageSizeMax

這會指定可開啟之圖表或圖像的大小上限 (以 MB 為單位)。預設值為 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

呈現任何單一圖表所花的時間上限 (以秒為單位)。

有效值：-1 (無限制)；從 1 到 2073600 (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

-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 設定以外的所有設定都將覆寫活頁簿設定。如果此參數已變更，則會在重新整理 ConfigDB 屬性快取時，套用至 Excel Services Application 上的所有新會話。預設設定為 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

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

其類型必須為有效的 GUID，且格式為 12345678-90ab-cdef-1234-567890bcdefgh；在伺服器陣列 (例如，MyExcelService1) 中，Excel Services 應用程式 Web 服務應用程式的有效名稱；或是有效之 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。

其類型必須為下列其中之一：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

-Identity

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

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

Type:	SPExcelFileLocationPipeBind
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013

-IncludeChildren

這會指定信任的下層 URL、目錄及程式庫。例如，如果受信任檔案位置為 https://portal，而且 IncludeChildren 為 True，則也會信任 https://portal/subSite，與 Address 中指定之 subURL 下的任何 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

位置的類型。 LocationType 指出Excel Services應用程式如何從 Address 中指定的位置擷取檔案。預設值為 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 Services應用程式等候的時間，以秒為單位。在這段期間內，可能會從外部資料快取，傳回來自先前外部資料要求的結果。

有效值為：

-1 第一次查詢之後永不重新整理

1 到 2073600 快取 1 秒到 24 天。

預設值為 300。

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 Services應用程式上保持作用中的時間，以秒為單位。預設值為 1800。有效值包括：

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

0，工作階段在單一要求結束時到期

1 到 2073600，保持使用中 1 秒到 24 天。

其類型必須為 -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

-PeriodicExtDataCacheLifetime

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

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

預設值為 300。

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

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

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

預設值為 300。

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

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

如果外部 DataAllowed 參數設定為 None，RESTExternalDataAllowed 參數將沒有任何作用。

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 Services應用程式上保持作用中的時間，以秒為單位。預設值為 300 秒。預設值為 300。有效值包括：

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

0，工作階段在單一要求結束時到期

1 到 2073600，保持使用中 1 秒到 24 天

其類型必須為 -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

-ShortSessionTimeout

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

其類型必須為 -1，或是介於 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

-UdfsAllowed

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

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

這會指定可載入之活頁簿的大小上限 (以 MB 為單位)。預設值為 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

共用方式為

Set-SPExcelFileLocation

Syntax

Description

範例

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

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

參數

-AbortOnRefreshOnOpenFail

-Address

-AssignmentCollection

-AutomaticVolatileFunctionCacheLifetime

-ChartAndImageSizeMax

-ChartRenderDurationMax

-ConcurrentDataRequestsPerSessionMax

-Confirm

-DefaultWorkbookCalcMode

-Description

-DisplayGranularExtDataErrors

-ExcelServiceApplication

-ExternalDataAllowed

-Identity

-IncludeChildren

-LocationType

-ManualExtDataCacheLifetime

-NewWorkbookSessionTimeout

-PeriodicExtDataCacheLifetime

-RequestDurationMax

-RESTExternalDataAllowed

-SessionTimeout

-ShortSessionTimeout

-UdfsAllowed

-WarnOnDataRefresh

-WhatIf

-WorkbookSizeMax

意見反應

其他資源