Set-SPUsageService
適用版本： SharePoint Foundation 2013, SharePoint Server 2013
上次修改主題的時間： 2015-03-09
設定流量報告服務的屬性。
Syntax
Set-SPUsageService [[-Identity] <SPUsageServicePipeBind>] [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-LoggingEnabled <Nullable>] [-UsageLogCutTime <UInt32>] [-UsageLogLocation <String>] [-UsageLogMaxSpaceGB <UInt32>] [-WhatIf [<SwitchParameter>]]
詳細描述
Set-SPUsageService Cmdlet 會更新流量報告服務的屬性。若未指定 Identity 參數，Cmdlet 就會套用變更至本機流量報告服務。
Parameters
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
Microsoft.SharePoint.PowerShell.SPUsageServicePipeBind |
指定要更新的流量報告服務。 此類型必須是格式為 12345678-90ab-cdef-1234-567890bcdefgh 的有效 GUID；有效的流量報告服務名稱 (例如 UsageService1)；或有效之 SPUsageService 物件的執行個體。 |
AssignmentCollection |
選用 |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
為能適當處置物件而管理物件。使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。 注意 使用 Global 參數時，所有物件會包含在全域儲存區內。若未立即使用物件，或未使用 Stop-SPAssignment 命令處置物件，將會發生記憶體不足的狀況。 |
Confirm |
選用 |
System.Management.Automation.SwitchParameter |
執行命令之前，會先提示您進行確認。如需詳細資訊，請輸入下列命令：get-help about_commonparameters |
LoggingEnabled |
選用 |
System.Nullable |
指定記錄至流量檔案的流量資料。 |
UsageLogCutTime |
選用 |
System.UInt32 |
指定每個流量記錄檔收集流量資料的時間 (以分鐘為單位)。預設設定為 5 分鐘。 此類型必須是 1 至 1440 之間的整數。 |
UsageLogLocation |
選用 |
System.String |
指定要建立流量檔案之伺服器陣列中每部電腦的路徑。 此類型必須是下列其中一種格式的有效路徑： - C:\folder_name - \\server_name\folder_name |
UsageLogMaxSpaceGB |
選用 |
System.UInt32 |
指定流量檔案的可用空間，單位是 MB。有效範圍介於 500 到 20,000 MB。 預設值為 5,000。 |
WhatIf |
選用 |
System.Management.Automation.SwitchParameter |
顯示訊息描述命令效果，而非描述命令執行的效果。如需詳細資訊，請輸入下列命令：get-help about_commonparameters |
輸入類型
傳回類型
Example
--------------------範例-----------------
Set-SPUsageService -LoggingEnabled $false
Set-SPUsageService -UsageLogLocation "d:\\testusagelogdir
Set-SPUsageService -UsageLogCutTime 5
此範例會停用流量記錄，變更儲存流量記錄的目錄，以及每 5 分鐘建立新的流量記錄檔。