Remove-CsDiagnosticConfiguration
上一次修改主题: 2012-03-25
删除组织中当前正在使用的一个或多个诊断配置设置集合。诊断配置设置用于确定是否将往返于给定域或统一资源标识符 (URI) 的流量记录在 Microsoft Lync Server 2010 日志文件中。
语法
Remove-CsDiagnosticConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
如果对 Lync Server 2010 启用日志记录,则默认情况下会将往返于任何域或 URI 的流量包括在这些日志文件中。这可确保将尽可能多的信息记录在日志文件中。
但是,这有时可能会导致信息过多。例如,如果特定域存在连接问题,则您可能要限制只对网络与该域之间的流量进行日志记录;这样便于您识别相关记录,从而可能便于您诊断和更正该问题。
通过诊断配置设置,您可以指定要记录在日志文件中的域或 URI;如果启用了诊断筛选器,将仅记录往返于指定域的流量。通过 Lync Server,您可以在 site 作用域创建诊断配置设置并应用诊断筛选器。这样,您就可以对某个站点(如 Redmond 站点)应用筛选功能,并同时保持对其他站点禁用筛选功能。
您可以使用 Remove-CsDiagnosticConfiguration cmdlet 删除已在 site 作用域创建的任何诊断配置设置。还可针对全局诊断配置设置运行 Remove-CsDiagnosticConfiguration cmdlet。但是,在这种情况下,将不会删除集合;因为 Lync Server 不允许您删除全局集合。删除全局集合会使该集合中的属性重置为其默认值。这意味着将删除添加到该集合的所有筛选器。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Remove-CsDiagnosticConfiguration cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsDiagnosticConfiguration"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
必需 |
Xds 标识 |
要删除的诊断配置设置的唯一标识符。要删除在 site 作用域配置的设置,请使用类似如下的语法:-Identity "site:Redmond"。 还可针对全局配置设置运行 Remove-CsDiagnosticConfiguration;在这种情况下,请使用以下语法:–Identity global.但是,不会真正删除全局设置;而是将全局设置中找到的属性重置为其默认值。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings 对象。Remove-CsDiagnosticConfiguration 接受通过管道传递的诊断筛选器设置对象的实例。
返回类型
无。Remove-CsDiagnosticConfiguration 会删除 Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings 对象的现有实例。
示例
-------------------------- 示例 1 --------------------------
Remove-CsDiagnosticConfiguration -Identity site:Redmond
上述命令删除 Identity 为 site:Redmond 的诊断配置设置。
-------------------------- 示例 2 --------------------------
Get-CsDiagnosticConfiguration -Filter site:* | Remove-CsDiagnosticConfiguration
示例 2 中显示的命令删除在 site 作用域配置的所有诊断配置设置。为执行此操作,该命令调用带有 Filter 参数的 Get-CsDiagnosticConfiguration;筛选器值“site:*”将返回的数据限制为 Identity 以字符“site:”开头的设置。然后,将筛选出的集合通过管道传递到 Remove-CsDiagnosticConfiguration,后者将删除该集合中的每一项。
-------------------------- 示例 3 --------------------------
Get-CsDiagnosticConfiguration | Remove-CsDiagnosticConfiguration
在示例 3 中,该命令删除组织中当前使用的所有诊断配置设置。为执行此任务,首先调用不带任何参数的 Get-CsDiagnosticConfiguration 以返回组织中当前正在使用的所有诊断配置设置的集合。然后,将这些项目通过管道传递给 Remove-CsDiagnosticConfiguration,后者会删除集合中的每一项。