Get-CsDiagnosticConfiguration

Skype for Business Server 2015
 

Дата изменения раздела:2017-03-28

Возвращает сведения о параметрах конфигурации диагностики, используемых в организации. Параметры конфигурации диагностики определяют, записывается ли обмен трафиком с конкретным доменом или универсальным кодом ресурса (URI) в файлы журнала Skype для бизнеса Server 2015. Данный командлет впервые появился в Lync Server 2010.

Get-CsDiagnosticConfiguration [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Get-CsDiagnosticConfiguration [-Filter <String>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-LocalStore <SwitchParameter>]

В примере 1 возвращаются сведения обо всех параметрах конфигурации диагностики, в настоящее время используемые в организации. Для этого сначала вызывается командлет Get-CsDiagnosticConfiguration без параметров.

Get-CsDiagnosticConfiguration

В примере 2 возвращаются сведения о параметрах конфигурации диагностики, применяемых для веб-сайта Редмонд (-Identity site:Redmond).

Get-CsDiagnosticConfiguration -Identity site:Redmond

Команда, показанная в примере 3 отображает сведения об отдельных фильтрах параметров конфигурации диагностики для веб-сайта Редмонд. Для этого команда сначала использует командлет Get-CsDiagnosticConfiguration , чтобы вернуть параметры для веб-сайта Редмонд. Затем эти данные поступают по конвейеру в командлет Select-Object с параметром ExpandProperty, чтобы "расширить" значение свойства Filter. Расширение свойства Filter позволяет получить доступ к отдельным фильтрам свойств и их значениям, фильтры сохраняются в параметрах конфигурации диагностики.

Get-CsDiagnosticConfiguration -Identity site:Redmond | Select-Object -ExpandProperty Filter

Команда, показанная в примере 4 возвращает поднабор фильтров, найденных в глобальных параметрах конфигурации диагностики; в частности, команда возвращает фильтры, в которых свойство Uri содержит SIP-адрес: sip:diagnostics@litwareinc.com. Сначала команда использует командлет Get-CsDiagnosticConfiguration , который возвращает все сведения о фильтре глобального экземпляра параметров конфигурации диагностики. Затем эти данные поступают по конвейеру в командлет Select-Object , который расширяет свойство Filter. Затем, отдельные объекты фильтров передаются по конвейеру в командлет Select-Object , который выбирает только те фильтры, где свойство Uri содержит SIP-адрес: sip:diagnostics@litwareinc.com.

Get-CsDiagnosticConfiguration -Identity global | Select-Object -ExpandProperty Filter | Where-Object {$_.Uri -contains "sip:diagnostics@litwareinc.com"}

Пример 5 — это разновидность команды, показанной в примере 4; однако в примере 5 фильтры возвращаются только в том случае, если свойство Uri не содержит SIP-адрес: sip:diagnostics@litwareinc.com адрес SIP. Для выполнения этой задачи команда вызывает командлет Get-CsDiagnosticConfiguration чтобы возвратить сведения конфигурации диагностики для глобального экземпляра параметров конфигурации. Затем эти данные поступают по конвейеру в командлет Select-Object , который расширяет свойство Filter. Эти объекты фильтров передаются по конвейеру в командлет Select-Object , который выбирает только те фильтры, где свойство Uri не содержит SIP-адрес: sip:diagnostics@litwareinc.com.

Get-CsDiagnosticConfiguration -Identity global | Select-Object -ExpandProperty Filter | Where-Object {$_.Uri -notcontains "sip:diagnostics@litwareinc.com"}

Если в Skype для бизнеса Server 2015 включено ведение журналов, то по умолчанию записи о передаче трафика из доменов или в домены, а также на URI-адреса включаются в эти файлы журнала. Таким образом в файлы журнала записывается максимальный набор сведений.

Однако иногда это может привести к слишком большому объему сведений. Например, если имеются проблемы подключения к конкретному домену, может потребоваться ограничить ведение журнала только трафиком между вашей сетью и этим доменом; это упрощает поиск соответствующих записей, что в свою очередь облегчает диагностику и устранение проблемы.

Параметры конфигурации диагностики позволяют указать домены или URI-адреса, которые будут записываться в файлы журналов. Skype для бизнеса Server 2015 позволяет создавать параметры конфигурации диагностики в области веб-сайта. В свою очередь, это дает возможность применять различные параметры для веб-сайта Редмонд в процессе работы на других сайтах.

Командлет Get-CsDiagnosticConfiguration возвращает сведения о параметрах конфигурации диагностики, в настоящее время используемых в организации.

По умолчанию право на локальный запуск командлета Get-CsDiagnosticConfiguration имеют члены следующих групп: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Чтобы получить список всех ролей управления доступом на основе ролей (RBAC), которым назначен этот командлет (включая все самостоятельно созданные роли RBAC), выполните в командной строке Windows PowerShell следующую команду:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsDiagnosticConfiguration"}

 

Параметр Обязательный? Тип Описание

Filter

Необязательный

System.String

Позволяет использовать подстановочные символы при указании возвращаемой коллекции параметров (или коллекций). Например, этот синтаксис возвращает все параметры, настроенные в области веб-сайта: -Filter "site:*".

В одной команде нельзя одновременно использовать параметры Filter и Identity.

Identity

Необязательный

Microsoft.Rtc.Management.Xds.XdsIdentity

Уникальный идентификатор для возвращаемых параметров конфигурации диагностики. Чтобы возвратить параметры, которые настроены в области веб-сайта, используйте синтаксис, подобный следующему: -Identity "site:Redmond". Чтобы вернуть глобальные параметры, используйте следующий синтаксис: -Identity global.

Если этот параметр не задан, то будут возвращаться все параметры конфигурации диагностики, используемые в настоящее время.

LocalStore

Необязательный

System.Management.Automation.SwitchParameter

Возвращает данные о конфигурации диагностики из локальной реплики центрального хранилища управления, а не из самого центрального хранилища управления.

Нет. Командлет Get-CsDiagnosticConfiguration не принимает входные данные из конвейера.

Командлет Get-CsDiagnosticConfiguration возвращает экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings.

 
Показ: