Set-SPUsageDefinition

設定使用情況提供者的保留期。

Syntax

Set-SPUsageDefinition
   [-Identity] <SPUsageDefinitionPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-DaysRetained <Int32>]
   [-DaysToKeepUsageFiles <Int32>]
   [-Enable]
   [-MaxTotalSizeInBytes <Int64>]
   [-WhatIf]
   [-UsageDatabaseEnabled]
   [<CommonParameters>]

Description

Cmdlet Set-SPUsageDefinition 會設定指定使用提供者的保留期間。 使用情況定義物件會定義特定類型的使用情況提供者。

如需適用於 SharePoint 產品的 Windows PowerShell 權限及最新資訊,請參閱線上文件 SharePoint Server Cmdlet

範例

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

Set-SPUsageDefinition -Identity "Page Requests" -DaysRetained 31

此範例會將儲存網頁要求使用狀況資料的天數設為 31。

參數

-AssignmentCollection

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Type:SPAssignmentCollection
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-DaysRetained

Specifies the number of days that usage data for the usage provider is retained in the usage service database. The default value is 14.

此類型必須是介於 0 與 31 之間的整數。

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-DaysToKeepUsageFiles

Specifies the number of days to keep usage file retention. The value must be less than or equal to value of the DaysRetained parameter.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Enable

開啟指定的使用情況提供者。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Identity

指定要更新的使用情況定義物件。

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

Type:SPUsageDefinitionPipeBind
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-MaxTotalSizeInBytes

此參數會儲存此提供者資料的最大 SQL 儲存體大小。

Type:Int64
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-UsageDatabaseEnabled

設定 為將使用量資料從本機伺服器匯出至 Usage 資料庫。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition