Get-CsDiagnosticConfiguration
上一次修改主题： 2012-03-23
返回有关当前组织中使用的诊断配置设置的信息。诊断配置设置用于确定是否将往返于给定域或统一资源标识符 (URI) 的流量记录在 Microsoft Lync Server 2010 日志文件中。
语法
Get-CsDiagnosticConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsDiagnosticConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
详细说明
如果对 Lync Server 2010 启用日志记录，则默认情况下会将往返于任何域或 URI 的流量包括在这些日志文件中。这可确保将尽可能多的信息记录在日志文件中。
但是，这有时可能会导致信息过多。例如，如果特定域存在连接问题，则您可能要限制只对网络与该域之间的流量进行日志记录；这样便于您识别相关记录，从而可能便于您诊断和更正该问题。
通过诊断配置设置，您可以指定要记录在日志文件中的域或 URI。通过 Lync Server，您可以在 site 作用域创建诊断配置设置。接下来，您就可以对 Redmond 站点应用与其他站点不同的设置。
通过 Get-CsDiagnosticConfiguration cmdlet，可以返回有关组织中当前使用的诊断配置设置的信息。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsDiagnosticConfiguration cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsDiagnosticConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
要返回的诊断配置设置的唯一标识符。要返回在 site 作用域配置的设置，请使用类似如下的语法：-Identity "site:Redmond"。要返回全局设置，请使用以下语法：-Identity global。 如果未指定此参数，则会返回当前使用的所有诊断配置设置。 |
Filter |
可选 |
字符串 |
使您可以在指定要返回的设置集合时使用通配符。例如，以下语法返回在 site 作用域配置的所有设置：-Filter "site:*"。 请注意，不能在同一个命令中同时使用 Filter 和 Identity 参数。 |
LocalStore |
可选 |
开关参数 |
从中央管理存储的本地副本，而非中央管理存储本身检索诊断配置数据。 |
输入类型
无。Get-CsDiagnosticConfiguration 不接受通过管道传递的输入。
返回类型
Get-CsDiagnosticConfiguration 返回 Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Get-CsDiagnosticConfiguration
在示例 1 中，将返回有关组织中当前使用的所有诊断配置设置的信息。这是通过调用不带任何参数的 Get-CsDiagnosticConfiguration 实现的。
-------------------------- 示例 2 --------------------------
Get-CsDiagnosticConfiguration -Identity site:Redmond
上述命令返回应用于 Redmond 站点 (-Identity site:Redmond) 的诊断配置设置的信息。
-------------------------- 示例 3 --------------------------
Get-CsDiagnosticConfiguration -Identity site:Redmond | Select-Object -ExpandProperty Filter
示例 3 中显示的命令显示有关包含在 Redmond 站点的诊断配置设置中的各个筛选器的信息。为执行此操作，该命令首先使用 Get-CsDiagnosticConfiguration 返回 Redmond 站点的设置。然后，将该信息通过管道传递到 Select-Object cmdlet，后者会使用 ExpandProperty 参数“展开”Filter 属性的值。通过展开 Filter 属性，您可以访问在诊断配置设置中维护的各个筛选器的属性和属性值。
-------------------------- 示例 4 --------------------------
Get-CsDiagnosticConfiguration -Identity global | Select-Object -ExpandProperty Filter | Where-Object {$_.Uri -contains "sip:diagnostics@litwareinc.com"}
示例 4 中显示的命令返回在全局诊断筛选器配置设置中找到的筛选器子集；具体而言，该命令返回 Uri 属性包括 SIP 地址 sip:diagnostics@litwareinc.com 的筛选器。为此，该命令首先使用 Get-CsDiagnosticConfiguration 返回诊断配置设置的全局实例的所有筛选器信息。然后，将该信息通过管道传递到 Select-Object cmdlet，后者会展开 Filter 属性。接下来，将各个筛选器对象通过管道传递到 Select-Object，后者会仅提取 Uri 属性包括 SIP 地址 sip:diagnostics@litwareinc.com 的筛选器。
-------------------------- 示例 5 --------------------------
Get-CsDiagnosticConfiguration -Identity global | Select-Object -ExpandProperty Filter | Where-Object {$_.Uri -notcontains "sip:diagnostics@litwareinc.com"}
示例 5 是示例 4 中显示的命令的变体；但在示例 5 中，仅返回 Uri 属性不包括 SIP 地址 sip:diagnostics@litwareinc.com 的筛选器。为执行此任务，该命令调用 Get-CsDiagnosticConfiguration 以返回配置设置的全局实例的所有诊断配置信息。然后，将该信息通过管道传递到 Select-Object cmdlet，后者会展开 Filter 属性。接下来，将这些筛选器对象通过管道传递到 Select-Object，后者将仅选择 Uri 属性不包括 SIP 地址 sip:diagnostics@litwareinc.com 的筛选器。