Share via


Set-SPUsageApplication

 

適用版本: SharePoint Foundation 2013, SharePoint Server 2013

上次修改主題的時間: 2015-03-09

設定使用情況應用程式的屬性。

Syntax

Set-SPUsageApplication [-Identity] <SPUsageApplicationPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-DatabaseName <String>] [-DatabasePassword <SecureString>] [-DatabaseServer <String>] [-DatabaseUsername <String>] [-EnableLogging <SwitchParameter>] [-FailoverDatabaseServer <String>] [-UsageService <SPUsageServicePipeBind>] [-WhatIf [<SwitchParameter>]]

詳細描述

Set-SPUsageApplication Cmdlet 會設定使用狀況應用程式的屬性。

如需 Windows PowerShell for SharePoint 產品的權限及最新資訊,請參閱線上說明文件 (https://go.microsoft.com/fwlink/?LinkId=163185)。

Parameters

參數 必要 輸入 描述

Identity

必要

Microsoft.SharePoint.PowerShell.SPUsageApplicationPipeBind

指定要更新的使用狀況應用程式。

此類型必須是格式為 12345678-90ab-cdef-1234-567890bcdefgh 的有效 GUID、有效的使用情況應用程式名稱 (例如 UsageApp1),或有效之 SPServiceApplication 物件的執行個體。

AssignmentCollection

選用

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

為能適當處置物件而管理物件。使用 SPWebSPSite 等物件可能會耗用大量的記憶體,因此在 Windows PowerShell 指令碼中使用這些物件時,必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數,並在不需要時處置這些物件,以釋放記憶體。使用 SPWebSPSiteSPSiteAdministration 物件時,若未使用指派集合或 Global 參數,將會自動處置這些物件。

注意

使用 Global 參數時,所有物件會包含在全域儲存區內。若未立即使用物件,或未使用 Stop-SPAssignment 命令處置物件,將會發生記憶體不足的狀況。

Confirm

選用

System.Management.Automation.SwitchParameter

執行命令之前,會先提示您進行確認。如需詳細資訊,請輸入下列命令:get-help about_commonparameters

DatabaseName

選用

System.String

指定記錄資料庫的名稱。

此類型必須是有效的 SQL Server 資料庫名稱,例如 UsageLogDB1。

If the logging database does not exist, a logging database will be automatically created.

DatabasePassword

選用

System.Security.SecureString

指定密碼給在 DatabaseUserName 中指定的使用者。唯有在使用 SQL Server 驗證存取記錄資料庫的情況下,才使用此參數。

此類型必須是有效的密碼。

DatabaseServer

選用

System.String

指定 DatabaseName 中所指定之資料庫的主機伺服器名稱。

此類型必須是有效的 SQL Server 主機名稱,例如 SQLServerHost1。

DatabaseUsername

選用

System.String

指定用來連接到記錄資料庫的使用者名稱。唯有在使用 SQL Server 驗證存取記錄資料庫時,才使用此參數。

此類型必須是有效的使用者名稱,例如 UserName1。

EnableLogging

選用

System.Management.Automation.SwitchParameter

指定此使用狀況應用程式收集使用資料。

FailoverDatabaseServer

選用

System.String

UsageService

選用

Microsoft.SharePoint.PowerShell.SPUsageServicePipeBind

指定此使用狀況應用程式父項的 SPUsageService 物件。

此類型必須是格式為 12345678-90ab-cdef-1234-567890bcdefgh 的有效 GUID;有效的流量報告服務名稱 (例如 UsageService1);或有效之 SPUsageService 物件的執行個體。

WhatIf

選用

System.Management.Automation.SwitchParameter

顯示訊息描述命令效果,而非描述命令執行的效果。如需詳細資訊,請輸入下列命令:get-help about_commonparameters

輸入類型

傳回類型

Example

-------------------範例----------------------

Set-SPUsageApplication -Identity "Usage and Health data collection" -DatabaseServer "Server Name" -DatabaseName "New Logging DB

此範例會變更流量記錄服務用來儲存記錄資料的資料庫伺服器與資料庫名稱。

See Also

Reference

Get-SPUsageApplication
New-SPUsageApplication
Remove-SPUsageApplication