New-CsDiagnosticsFilter

Skype for Business Server 2015
 

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

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

New-CsDiagnosticsFilter [-Enabled <$true | $false>] [-ExcludeConferenceMessages <$true | $false>] [-ExcludePresenceNotifications <$true | $false>] [-ExcludeRegisterMessages <$true | $false>] [-ExcludeSubscribeMessages <$true | $false>] [-ExcludeSuccessfulRequests <$true | $false>] [-Fqdn <PSListModifier>] [-Uri <PSListModifier>]

Команда в примере 1 запускает командлет New-CsDiagnosticsFilter для создания нового фильтра диагностики, а затем применяет его к глобальным параметрам конфигурации. Для этого команда сначала запускает командлет New-CsDiagnosticsFilter , создавая фильтр диагностики, хранящийся только в оперативной памяти. К фильтру добавляется FQDN fabrikam.com и URI user@fabrikam.com. Команда также устанавливает значение True ($True) для свойства Enabled, чтобы активировать фильтр. Затем полученный виртуальный фильтр сохраняется в переменной $x.

Вторая команда запускает командлет Set-CsDiagnosticConfiguration , чтобы применить новый фильтр к глобальным параметрам диагностической конфигурации. В этом случае любые значения свойства Filter заменяются на значения фильтра, сохраненного в $x.

$x = New-CsDiagnosticsFilter -Fqdn "fabrikam.com" -Enabled $False
Set-CsDiagnosticConfiguration -Identity global -Filter $x 

Команды в примере 2 представляют собой варианты команд из примера 1, но при этом в примере 2 к свойству фильтра Fqdn добавляются два FQDN (fabrikam.com и contoso.com). Для этого оба имени (разделенные запятой) используются в качестве значений параметров Fqdn.

$x = New-CsDiagnosticsFilter -Fqdn "fabrikam.com","contoso.com" -Enabled $False
Set-CsDiagnosticConfiguration -Identity global -Filter $x

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

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

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

Командлет New-CsDiagnosticsFilter добавляет фильтр в коллекцию параметров диагностики. Эта коллекция содержит домены и URI, трафик которых записывается в файлы журнала. После добавления фильтра записывается только информация, относящаяся к доменам и URI. При этом трафик других доменов и URI игнорируется.

Обратите внимание, что командлет New-CsDiagnosticsFilter создает экземпляры фильтра диагностики, хранящиеся только в оперативной памяти. После создания виртуального фильтра для его добавления в коллекцию понадобится командлет New-CsDiagnosticConfiguration или Set-CsDiagnosticConfiguration .

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

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

 

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

Enabled

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

System.Boolean

Указывает, применяется фильтр или нет. По умолчанию установлено значение True ($True).

ExcludeConferenceMessages

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

System.Boolean

Если установлено значение True, данные о сообщениях конференции (то есть, любые сообщения с URI конференции в заголовке "Кому" или "От") не записываются в файлы журнала. Значение по умолчанию — False.

ExcludePresenceNotifications

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

System.Boolean

Если установлено значение True, данные об уведомлениях о присутствии (то есть, любые сообщения, использующие метод NOTIFY и BENOTIFY) не записываются в файлы журнала. Значение по умолчанию — False.

ExcludeRegisterMessages

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

System.Boolean

Если установлено значение True, данные о регистрации клиентов (то есть, любые сообщения, использующие метод REGISTER) не записываются в файлы журнала. Значение по умолчанию — False.

ExcludeSubscribeMessages

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

System.Boolean

Если установлено значение True, данные о подписке клиентов (то есть, любые сообщения, использующие метод SUBSCRIBE) не записываются в файлы журнала. Значение по умолчанию — False.

ExcludeSuccessfulRequests

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

System.Boolean

Если установлено значение True, данные об успешных запросах SIP не будут записываться в файлы журнала (будут записываться только данные о запросах, которые завершились с ошибкой).

Fqdn

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

System.Management.Automation.PSListModifier

Коллекция доменов, включенных в фильтр (домены, имя которых содержится в части SIP-адреса, обозначающей узел). В значении свойства FQDN может использоваться полное имя домена (FQDN), например: fabrikam.com. Также для обозначения нескольких доменов можно использовать подстановочные знаки: *.fabrikam.com. В одном фильтре может быть указано несколько доменов.

Uri

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

System.Management.Automation.PSListModifier

Коллекция URI, включаемых в фильтр (URI — это часть SIP-адреса, выглядящая как user@host). URI может состоять из следующих частей:

user@fabrikam.com

user@*

*@fabrikam.com

В один фильтр можно включить несколько URI.

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

Командлет New-CsDiagnosticsFilter создает новые экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.Filter.

 
Показ: