New-SPWebAnalyticsServiceApplication
適用版本： SharePoint Server 2010
上次修改主題的時間： 2015-03-09
將新的 Web Analytics Service 應用程式新增至伺服器陣列。
Syntax
New-SPWebAnalyticsServiceApplication -ApplicationPool <SPIisWebServiceApplicationPoolPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-EnableDataTrimming <SwitchParameter>] [-ListOfReportingDatabases <String>] [-ListOfStagingDatabases <String>] [-MaxAggregationDepth <String>] [-MinAggregationDepth <String>] [-Name <String>] [-ReportingDataRetentionPeriod <Int32>] [-SamplingRate <Int32>] [-WhatIf [<SwitchParameter>]]
詳細描述
New-WebAnalyticsServiceApplication Cmdlet 會在伺服器陣列中建立新的 Web Analytics Service 應用程式。
如需 Windows PowerShell for SharePoint Server 2010 的權限及最新資訊，請參閱 TechNet (https://go.microsoft.com/fwlink/?LinkId=163183)。
Parameters
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
ApplicationPool |
必要 |
Microsoft.SharePoint.PowerShell.SPIisWebServiceApplicationPoolPipeBind |
指定在服務應用程式中執行 Web 服務的現有 IIS 應用程式集區。 此類型必須是格式為 12345678-90ab-cdef-1234-567890bcdefgh 的有效 GUID；格式為 http://server_name 的有效搜尋應用程式 URL；或有效之 SPIisWebServiceApplicationPool 物件的執行個體。 |
Name |
選用 |
System.String |
指定新 Web Analytics Service 應用程式的顯示名稱。所用名稱必須是此伺服器陣列中 Web Analytics Service 應用程式的唯一名稱。名稱最多可為 128 個字元，不可包含無效字元，如逗點 (,)、等號 (=) 或冒號 (:)。 此類型必須是服務應用程式 Proxy 的有效名稱，例如 WebAnalyticsSvc1。 |
ReportingDataRetentionPeriod |
選用 |
System.Int32 |
指定資料保留在 Web Analytics Reporting 資料庫中的期間 (以月計)。預設值為 25。 介於 1 至 25 之間的整數。 |
ListOfReportingDatabases |
選用 |
System.String |
指定 Web Analytics Reporting 資料庫的伺服器及資料庫名稱。此參數值為包含伺服器名稱與資料庫名稱的 XML 字串。 此類型必須是有效的 XML 字串。 |
ListOfStagingDatabases |
選用 |
System.String |
指定 Web Analytics Staging 資料庫的伺服器及資料庫名稱。此參數值為包含伺服器名稱與資料庫名稱的 XML 字串。 此類型必須是有效的 XML 字串。 |
MaxAggregationDepth |
選用 |
System.String |
指定 Report Consolidator 元件將用來彙總資料的彙總層級上限。MaxAggregationDepth 參數應一律與 MinAggregationDepth 參數搭配使用。 針對 MaxAggregationDepth 參數指定的值應一律大於 MinAggregationDepth 參數值。 可能值的範圍 (依遞增順序排序)：All、WebApplication、SiteCollection、Site、 預設值為 Web Application。 |
MinAggregationDepth |
選用 |
System.String |
指定 Report Consolidator 將用來彙總資料的彙總層級下限。MinAggregationDepth 參數應一律與 MaxAggregationDepth 參數搭配使用。 針對 MinAggregationDepth 參數指定的值應小於 MaxAggregationDepth 參數值。 可能值的範圍 (依遞增順序排序)：Web Application、SiteCollection、Site。 預設值為 WebApplication。 |
SamplingRate |
選用 |
System.Int32 |
指定傳入資料的範例速率。這可控制節流，降低要處理的資料量。後端程序會估算原有的流量值。預設值為 100。 此類型必須是 0 至 100 之間的整數。 |
AssignmentCollection |
選用 |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
為能適當處置物件而管理物件。使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。 注意 使用 Global 參數時，所有物件會包含在全域儲存區內。若未立即使用物件，或未使用 Stop-SPAssignment 命令處置物件，將會發生記憶體不足的狀況。 |
EnableDataTrimming |
選用 |
System.Management.Automation.SwitchParameter |
啟用時，報告資料庫中資料的列數會調整為每個元件 (Site、Site collection、Web Application) 每日 20,000 列。通常會啟用 EnableDataTrimming 參數，以提升 Web Analytics Report Consolidator 元件的效能。 預設值為 False。 |
Confirm |
選用 |
System.Management.Automation.SwitchParameter |
執行命令之前，會先提示您進行確認。如需詳細資訊，請輸入下列命令：get-help about_commonparameters |
WhatIf |
選用 |
System.Management.Automation.SwitchParameter |
顯示訊息描述命令效果，而非描述命令執行的效果。如需詳細資訊，請輸入下列命令：get-help about_commonparameters |
輸入類型
傳回類型
Example
---------------------範例-------------------
New-SPWebAnalyticsServiceApplication -Name WebAnalyticsServiceApplication1 -ReportingDataRetention 20 -SamplingRate 100 -ApplicationPool WebAnalyticsServiceApplication1
此範例會建立新的 Web Analytics Service 應用程式。
See Also
Reference
Get-SPWebAnalyticsServiceApplication
Set-SPWebAnalyticsServiceApplication