Set-SPUsageDefinition
适用于： SharePoint Foundation 2010, SharePoint Server 2010
上一次修改主题： 2015-03-09
设置使用率提供程序的保留期。
Syntax
Set-SPUsageDefinition [-Identity] <SPUsageDefinitionPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-DaysRetained <Int32>] [-Enable <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
Set-SPUsageDefinition cmdlet 可设置指定使用率提供程序的保留期。使用率定义对象定义使用率提供程序的特定类型。
有关 Windows PowerShell for SharePoint 产品的权限和最新信息，请参阅联机文档 (https://go.microsoft.com/fwlink/?LinkId=163185)。
Parameters
| 参数 | 必需 | 类型 | 说明 |
|---|---|---|---|
Identity |
必需 |
Microsoft.SharePoint.PowerShell.SPUsageDefinitionPipeBind |
指定要更新的使用率定义对象。 类型必须是有效的 GUID（格式为 12345678-90ab-cdef-1234-567890bcdefgh）；或是使用率定义的有效名称（例如，SiteSubscriptionConfig1）或有效的 SPUsageDefinition 对象的实例。 |
AssignmentCollection |
可选 |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
管理对象以便正确进行处理。使用 SPWeb 或 SPSite 等对象可能会耗用大量内存，而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象，可以将对象分配给变量，然后在不需要这些对象时对它们进行处理，以释放内存。在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时，如果不使用分配集合或 Global 参数，则会自动处理这些对象。 .gif "注意") Note
在使用 Global 参数时，所有对象均包含在全局存储中。如果未立即使用对象，或未通过使用 Stop-SPAssignment 命令来处理对象，则可能会发生内存不足的情况。
|
Confirm |
可选 |
System.Management.Automation.SwitchParameter |
在执行命令之前提示您确认。有关详细信息，请键入以下命令：get-help about_commonparameters |
DaysRetained |
可选 |
System.Int32 |
指定使用率提供程序的使用率数据在使用率服务数据库中保留的天数。默认值为 14。 键入的值必须是介于 0 和 31 之间的整数。 |
Enable |
可选 |
System.Management.Automation.SwitchParameter |
启用指定的使用率提供程序。 |
WhatIf |
可选 |
System.Management.Automation.SwitchParameter |
显示一条描述命令作用的消息，而不执行命令。有关详细信息，请键入以下命令：get-help about_commonparameters |
输入类型
返回类型
Example
-----------------示例--------------------
Set-SPUsageDefinition -Identity "Page Requests" -DaysRetained 31
此示例将页面请求使用率数据的存储天数设置为 31 天。