Set-SPAccessServiceApplication
適用版本: SharePoint Server 2010
上次修改主題的時間: 2015-03-09
在 Microsoft SharePoint Server 2010 中設定現有的 Access Services 應用程式的全域屬性。
Syntax
Set-SPAccessServiceApplication [-Identity] <SPAccessServiceApplicationPipeBind> [-ApplicationLogSizeMax <Int32>] [-AssignmentCollection <SPAssignmentCollection>] [-CacheTimeout <Int32>] [-ColumnsMax <Int32>] [-Confirm [<SwitchParameter>]] [-NonRemotableQueriesAllowed <SwitchParameter>] [-OrderByMax <Int32>] [-OuterJoinsAllowed <SwitchParameter>] [-OutputCalculatedColumnsMax <Int32>] [-PrivateBytesMax <Int32>] [-RecordsInTableMax <Int32>] [-RequestDurationMax <Int32>] [-RowsMax <Int32>] [-SessionMemoryMax <Int32>] [-SessionsPerAnonymousUserMax <Int32>] [-SessionsPerUserMax <Int32>] [-SourcesMax <Int32>] [-TemplateSizeMax <Int32>] [-WhatIf [<SwitchParameter>]]
詳細說明
Set-SPAccessServiceApplication Cmdlet 會在 SharePoint Server 2010 中,設定現有的 Access Services 應用程式的全域執行階段屬性。使用這個 Cmdlet 對屬性所做的變更,會影響執行這個 Access Services 應用程式之伺服器陣列中的所有機器。
如需權限以及有關 Windows PowerShell for SharePoint Server 2010 的最新資訊,請參閱 TechNet (https://go.microsoft.com/fwlink/?LinkId=163183)。
Parameters
參數 | 必要 | 類型 | 說明 |
---|---|---|---|
Identity |
必要 |
Microsoft.Office.Access.Server.PowerShell.SPAccessServiceApplicationPipeBind |
這會指定要更新的 Access Services 應用程式。 其類型必須為 Access Services 應用程式的有效名稱;例如,AccessSrvApp1;有效的 GUID,且格式為 12345678-90ab-cdef-1234-567890bcdefgh;或是有效之 SPAccessServiceApplication 物件的執行個體。 |
ApplicationLogMaxSize |
選用 |
System.Int32 |
Access Services 應用程式記錄檔清單的最大記錄筆數。有效值:-1 到 maxint。0 值表示不允許。預設值為 3000。 |
AssignmentCollection |
選用 |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
為能適當處置物件而管理物件。使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體,因此在 Windows PowerShell 指令碼中使用這些物件時,必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數,並在不需要時處置這些物件,以釋放記憶體。使用 SPWeb、SPSite 或 SPSiteAdministration 物件時,若未使用指派集合或 Global 參數,將會自動處置這些物件。 注意 使用 Global 參數時,所有物件會包含在全域儲存區內。若未立即使用物件,或未使用 Stop-SPAssignment 命令處置物件,將會發生記憶體不足的狀況。 |
CacheTimeout |
選用 |
System.Int32 |
這會指定資料快取在沒有使用者活動的情況下,在 Access Services 上保持使用中的秒數。有效值包括:-1,快取永不逾時;1 到 2073600,快取保持使用中的時間為 1 秒到 24 天。 其類型必須為整數 -1,或是介於 1 到 2073600 (24 天) 的整數。預設值為 300。 |
ColumnsMax |
選用 |
System.Int32 |
這會指定查詢中的清單可包含的欄數上限,或是查詢的輸出可包含的欄數上限。預設值為 30。 其類型必須為整數,且介於 1 到 255 之間。 |
Confirm |
選用 |
System.Management.Automation.SwitchParameter |
執行命令之前,會先提示您進行確認。如需詳細資訊,請輸入下列命令:get-help about_commonparameters |
NonRemotableQueriesAllowed |
選用 |
System.Management.Automation.SwitchParameter |
這會指定無法從遠端傳送至資料庫層的查詢,都可以執行。 |
OrderByMax |
選用 |
System.Int32 |
這會指定查詢中的 Order By 子句數目的上限。預設值為 4。 其類型必須為整數,且介於 1 到 8 之間。 |
OuterJoinsAllowed |
選用 |
System.Management.Automation.SwitchParameter |
這會指定可支援右外部聯結。內部聯結一律支援。 |
OutputCalculatedColumnsMax |
選用 |
System.Int32 |
這會指定計算結果欄數的上限,這可以包含在輸出中,成為查詢的一部分。基準 SharePoint 清單中的計算結果欄不包括在內。預設值為 10。 其類型必須為整數,且介於 1 到 32 之間。 |
PrivateBytesMax |
選用 |
System.Int32 |
這會指定 Access Services 可使用的私用位元組上限 (以 MB 為單位)。若設定為 -1,就會預設為機器上實體記憶體的 75%。有效值:-1、無限制,以及從 1 到任何正整數。 預設值為 -1。 |
RecordsInTableMax |
選用 |
System.Int32 |
這會指定 Access Services 應用程式中,資料表的記錄數目上限。有效值包括:-1、無限制,以及從 1 到任何正整數。預設值為 500000。 其類型必須為整數 -1,或是介於 1 到 MaxInt 的整數。 |
RequestDurationMax |
選用 |
System.Int32 |
這會指定執行作業的要求可使用的秒數上限,超過就會逾時。有效值包括:-1、無限制,以及從 1 到 2073600,快取保持使用中的時間為 1 秒到 24 天。預設值為 30。 其類型必須為整數 -1,或是介於 1 到 2073600 (24 天) 的整數 |
RowsMax |
選用 |
System.Int32 |
這會指定查詢中的清單可包含的列數上限,或是查詢的輸出可包含的列數上限。預設值為 50000。 其類型必須為整數,且介於 1 到 200000 之間。 |
SessionMemoryMax |
選用 |
System.Int32 |
這會指定個別工作階段的大小上限 (以 MB 為單位)。有效值包括:0,表示停用屬性,以及 1 到 4095。預設值為 64。 其類型必須為整數 0,或是介於 1 到 4095 的整數。 |
SessionsPerAnonymousUserMax |
選用 |
System.Int32 |
每位使用者的工作階段數目上限。若達到此上限,當新的工作階段開始時,最舊的工作階段將遭到刪除。有效值包括:-1,無限制,以及從 1 到任何正整數。預設值為 10。 整數 -1,或介於 1 到 MaxInt 的整數 |
SessionsPerUserMax |
選用 |
System.Int32 |
這會指定每位使用者的工作階段數目上限。若達到此上限,當新的工作階段開始時,最舊的工作階段將遭到刪除。有效值包括:-1,無限制,以及從 1 到任何正整數。預設值為 10。 整數 -1,或介於 1 到 MaxInt 的整數。 |
SourcesMax |
選用 |
System.Int32 |
這會指定要使用清單做為查詢的輸入時,每次可使用的清單數目上限。預設值為 8。 其類型必須為整數,且介於 1 到 20 之間。 |
TemplateSizeMax |
選用 |
System.Int32 |
上傳到解決方案庫的 Access 範本 (.accdt 檔案) 之大小上限 (以 MB 為單位)。有效值為:-1,無限制,以及從 1 到任何正整數。 |
WhatIf |
選用 |
System.Management.Automation.SwitchParameter |
顯示訊息描述命令效果,而非描述命令執行的效果。如需詳細資訊,請輸入下列命令:get-help about_commonparameters |
輸入類型
傳回類型
Example
------------範例 1------------------
Set-SPAccessServiceApplication -identity "MyAccessService" -requestDurationMax 100
此範例會將名為 MyAccessService
的 Access Services 應用程式,設定為允許要求在逾時之前等候長達 100
秒。
------------範例 2------------------
Get-SPAccessServiceApplication | Set-SPAccessServiceApplication -sessionsPerUserMax 5
此範例會將伺服器陣列中的每一個 Access Services 應用程式,設定為允許每個執行 Access Services 之後端應用程式伺服器電腦上的每一位使用者,最多可以有五個工作階段。
首先,會擷取每一個 Access Services 應用程式,然後使用 Set-SPAccessServiceApplication Cmdlet 設定新值。
------------範例 3------------------
Get-SPAccessServiceApplication | where {$_.rowsMax -gt 50000 } | Set-SPAccessServiceApplication -rowsMax 50000
此範例會針對伺服器陣列中的每一個允許查詢傳回或使用 50,000 列以上的 Access Services 應用程式,將服務應用程式設定為最多只允許 50,000 列。
首先,會擷取有 50,000 列以上的每個 Access Services 應用程式,然後使用 Set-SPAccessServiceApplication Cmdlet 設定新值。