New-SPExcelFileLocation

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

Syntax

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

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

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

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

範例

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

Get-SPExcelServiceApplication -identity "MyExcelService" | New-SPExcelFileLocation -address "https://myPortal/myTeam" -includechildren -locationType SharePoint -description "This is my team's site on myPortal." -workbooksizemax 50 -externaldataallowed DclAndEmbedded -WarnOnDataRefresh:$false

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

此範例可讓活頁簿從開頭為 的任何子資料夾或子資料夾載入 https://myPortal/myTeam. 從此位置載入的所有活頁簿大小必須小於 50 MB。 使用內嵌在活頁簿檔案或儲存在資料連線庫中的連線,這些活頁簿可以重新整理外部資料。 將不會顯示指出該活頁簿正嘗試重新整理外部資料的警告訊息。

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

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

此範例會將新的受信任檔案位置新增到 Excel Services 應用程式 Web 服務應用程式中名為 MyExcelService 且具有指定位址和描述的信任檔案位置清單。

參數

-AbortOnRefreshOnOpenFail

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

  • 使用者具有檔案的 [SharePoint 產品和技術] 唯讀權限。
  • 當 Excel Services 應用程式檔案開啟時,活頁簿檔案具有自動重新整理的資料連線。
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

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

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

Type:String
Position:Named
Default value:None
Required:True
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 天。 預設整數值為 300。

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

{{Fill ChartRenderDurationMax Description}}

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。

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

指定活頁簿允許的外部資料存取類型。 [無] 會指定停用資料重新整理。 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

-IncludeChildren

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

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

有效值為下列任一個項目:

-1,開始查詢後不再重新整理。1 到 2073600,快取 1 秒到 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

-NewWorkbookSessionTimeout

指定新的未儲存活頁簿會話在Excel Services應用程式上保持作用中,且沒有使用者活動的時間,以秒為單位。 有效值包括:

-1 會話永遠不會過期。

0 會話會在單一要求結束時到期。

1 到 2073600 保持作用中 1 秒到 24 天。 預設值為 1800。

其類型必須為 -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 指定在第一個查詢之後永不重新整理。 預設值為 300。

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

-RequestDurationMax

這會指定工作階段中單一要求的最長持續時間 (以秒為單位)。 經過此時間之後,要求就會逾時。預設值為 300。

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

-RESTExternalDataAllowed

這會指定是否允許來自代表性狀態傳輸 (REST) 應用程式開發介面 (API) 的要求重新整理外部資料連線。 如果 ExternalDataAllowed 參數設定為 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應用程式上保持作用中的時間,以秒為單位。 有效值包括:

-1 會話永遠不會過期。

0 個會話會在單一要求結束時過期。

1 到 2073600 保持作用中 1 秒到 24 天。 預設值為 300。

其類型必須為 -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 所指定) 載入之活頁簿,可以呼叫使用者定義的函數。

預設值為 False。

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