New-CsDiagnosticConfiguration

Skype for Business Server 2015
 

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

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

New-CsDiagnosticConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Filter <Filter>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-LogAllSipHeaders <$true | $false>] [-LoggingShare <String>] [-WhatIf [<SwitchParameter>]]

В примере 1 создается новая коллекция параметров диагностической конфигурации для веб-сайта Redmond.

New-CsDiagnosticConfiguration -Identity site:Redmond

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

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

$x = New-CsDiagnosticsFilter -Fqdn fabrikam.com -Uri "sip:user@fabrikam.com" -Enabled $False 

New-CsDiagnosticConfiguration -Identity site:Redmond -Filter $x

В примере 3 создаются параметры диагностической конфигурации, изначально существующие только в памяти. Для этого первая команда вызывает командлет New-CsDiagnosticConfiguration с двумя параметрами: Identity (определяет идентификатор параметров) и InMemory (указывает на то, что новые параметры должны создаваться только в памяти). Созданный объект сохраняется в переменной $x.

После создания виртуальных параметров вторая команда настраивает свойство LoggingShare, присваивая ему UNC-путь \\atl-fs-001\logs. Последняя команда преобразует виртуальные параметры диагностической конфигурации в фактическую коллекцию параметров, применяющуюся к сайту Redmond. Обратите внимание на то, что выполнение последней команды обязательно. Если не вызвать командлет Set-CsDiagnosticConfiguration , параметры не будут применены, а виртуальные параметры исчезнут по окончании сеанса работы с Windows PowerShell или при удалении переменной $x.

$x = New-CsDiagnosticConfiguration -Identity site:Redmond -InMemory
$x.LoggingShare = "\\atl-fs-001\logs"
Set-CsDiagnosticConfiguration -Instance $x

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

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

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

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

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

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

 

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

Identity

Обязательный

Microsoft.Rtc.Management.Xds.XdsIdentity

Создание уникального идентификатора параметров диагностической конфигурации. Так как новые параметры можно создавать только на уровне веб-сайта, нужно использовать следующий синтаксис: -Identity "site:Redmond".

Confirm

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

System.Management.Automation.SwitchParameter

Запрашивает подтверждение перед выполнением команды.

Filter

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

Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.Filter

Список доменов и URI, трафик которых записывается при включенном фильтре диагностики. Свойства фильтра состоят из трех пунктов:

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

Uri – список URI, включенных в фильтр (Uri — это часть SIP-адреса, содержащая значение user@host). Uri может включать любые из следующих шаблонов: user@fabrikam.com; user@*; *@fabrikam.com. В одном фильтре может быть несколько URI.

Enabled – указывает, включен ли фильтр.

Force

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

System.Management.Automation.SwitchParameter

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

InMemory

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

System.Management.Automation.SwitchParameter

Создает ссылку на объект без фиксации объекта в качестве постоянного изменения. Если выходные данные этого командлета, вызванного с помощью указанного параметра, назначаются переменной, можно внести изменения в свойства ссылки на объект и затем зафиксировать эти изменения, вызвав соответствующий командлет Set-<cmdlet> .

LogAllSipHeaders

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

System.Boolean

Если значение равно False, в журналы заносятся только ключевые заголовки SIP. Значение False, указанное для этого параметра, позволяет уменьшить размер файлов журнала. При использовании значения True в журнале регистрируются все заголовки SIP.

LoggingShare

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

System.String

Папка с общим доступом, куда отправляются файлы журнала диагностики.

WhatIf

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

System.Management.Automation.SwitchParameter

Описывает, что произойдет при выполнении команды без реального выполнения команды.

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

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

 
Показ: