Clear-CsDeviceUpdateLog
上一次修改主题: 2012-03-23
删除所有设备更新 Web 服务日志,并对超过指定天数的文件进行审核。
语法
Clear-CsDeviceUpdateLog -Identity <XdsIdentity> -DaysBack <Int32> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
设备更新 Web 服务将保留大量日志文件的集合;此集合包括由服务自身执行的审核日志以及从客户端设备(如手机)上载的日志文件。服务器可能很快因设备更新 Web 服务日志而变得“杂乱”,具体取决于设备更新活动的数量以及在组织中使用的客户端设备的数量。通过 Clear-CsDeviceUpdateLog cmdlet,您可以减少在服务器上存储的日志文件数量:只需运行 cmdlet,并指定不应当删除的文件的最长时间(以天为单位)。超过该最长时间的所有日志文件均将从系统删除。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Clear-CsDeviceUpdateLog cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Clear-CsDeviceUpdateLog"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
必需 |
Xds 标识 |
托管设备更新 Web 服务日志文件的服务的唯一标识符。例如,此语法从池 atl-cs-001.litwareinc.com 的 Web 服务清除设备更新 Web 服务日志文件:-Identity "service:WebServer:atl-cs-001.litwareinc.com"。 |
DaysBack |
必需 |
整数 |
保留日志文件的最长时间(以天为单位)。超过使用 DaysBack 参数指定的值的所有日志文件都将会删除。例如,如果将 DaysBack 设置为 7,则超过七天的所有日志文件都将删除。 此参数可以设置为 1 到 30(包含边界值)之间的任何整数值。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。Clear-CsDeviceUpdateLog 不接受通过管道传递的输入。
返回类型
无。Clear-CsDeviceUpdateLog 不返回任何值。
示例
-------------------------- 示例 1 ------------------------
Clear-CsDeviceUpdateLog -Identity "service:WebServer:atl-cs-001.litwareinc.com" -DaysBack 10
示例 1 中显示的命令会连接到 Identity 为“service:WebServer:atl-cs-001.litwareinc.com”的设备更新 Web 服务,删除所有超过 10 天的设备和审核日志。