Set-CsDiagnosticHeaderConfiguration

Skype for Business Server 2015
 

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

Изменяет существующий набор параметров конфигурации диагностических заголовков, которые в настоящее время используются в организации. Параметры конфигурации диагностических заголовков определяют, сопровождаются ли сообщения SIP информацией заголовка, которая может оказаться полезной при устранении неполадок и формировании отчетов об ошибках. Данный командлет впервые появился в Lync Server 2010.

Set-CsDiagnosticHeaderConfiguration [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Set-CsDiagnosticHeaderConfiguration [-Instance <PSObject>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-SendToExternalNetworks <$true | $false>] [-SendToExternalNetworksOnServiceEdge <$true | $false>] [-SendToOutsideUnauthenticatedUsers <$true | $false>] [-WhatIf [<SwitchParameter>]]

В примере 1 продемонстрировано изменение параметров конфигурации диагностических заголовков для узла Identity site:Redmond. В этом примере для свойства SendToOutsideUnauthenticatedUsers задано значение True.

Set-CsDiagnosticHeaderConfiguration -Identity site:Redmond -SendToOutsideUnauthenticatedUsers $True

Команда, представленная в примере 2, представляет собой вариант команды, показанной в примере 1; однако в данном случае свойство SendToOutsideUnauthenticatedUsers изменено для всех используемых параметров конфигурации диагностических заголовков. Для этого командлет Get-CsDiagnosticHeaderConfiguration сначала вызывается без каких-либо параметров; это приводит к возврату набора всех используемых параметров диагностических заголовков. Затем этот набор передается в командлет Set-CsDiagnosticHeaderConfiguration , который устанавливает значение True для свойства SendToOutsideUnauthenticatedUsers каждого объекта в наборе.

Get-CsDiagnosticHeaderConfiguration | Set-CsDiagnosticHeaderConfiguration -SendToOutsideUnauthenticatedUsers $True

В примере 3 снова изменяется свойство SendToOutsideUnauthenticatedUsers, но в данном случае это изменение затрагивает только те параметры диагностических заголовков, для свойства SendToExternalNetworks которых установлено значение True. Для выполнения этой задачи команда сначала использует командлет Get-CsDiagnosticHeaderConfiguration для возврата набора всех используемых в настоящий момент параметров конфигурации диагностических заголовков. Этот набор передается в командлет Where-Object , который выбирает только те параметры, свойству SendToExternalNetworks которых присвоено значение True. Эта отфильтрованная коллекция затем передается в командлет Set-CsDiagnosticHeaderConfiguration , который устанавливает значение True для свойства SendToOutsideUnauthenticatedUsers каждого объекта в наборе.

Get-CsDiagnosticHeaderConfiguration | Where-Object {$_.SendToExternalNetworks -eq $True} | Set-CsDiagnosticHeaderConfiguration -SendToOutsideUnauthenticatedUsers $True

Администраторы могут прикреплять диагностический ms-заголовок к каждому SIP-сообщению, передаваемому в организации. Это сообщение (которое не видят конечные пользователи) содержит информацию, которая может оказаться полезной при устранении неполадок связи или формировании отчетов об ошибках. Например, диагностический заголовок может содержать коды ошибок, которые позволяют клиентскому приложению (например, Skype для бизнеса) выполнять заданную последовательность действий при возникновении определенной ситуации.

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

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

Командлет Set-CsDiagnosticHeaderConfiguration предоставляет способ изменения существующего набора параметров конфигурации диагностических заголовков. Можно использовать этот командлет для включения (или выключения) передачи диагностических заголовков во внешние сети и/или внешним пользователям.

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

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

 

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

Confirm

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

System.Management.Automation.SwitchParameter

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

Force

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

System.Management.Automation.SwitchParameter

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

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

Если данный параметр не задан, то командлет Set-CsDiagnosticHeaderConfiguration автоматически изменит глобальные параметры.

Instance

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

Объект DiagnosticHeaderSettings

Позволяет передать в командлет ссылку на объект вместо задания значений отдельных параметров.

SendToExternalNetworks

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

System.Boolean

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

SendToExternalNetworksOnServiceEdge

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

System.Boolean

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

SendToOutsideUnauthenticatedUsers

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

System.Boolean

Если установлено значение True, диагностические заголовки будут прикреплены к сообщениям, отправляемым внешним пользователям. Внешние пользователи — это пользователи, которые подключены к внутренней сети извне (например, через прокси-сервер) и еще не прошли проверку подлинности.

Значение по умолчанию — False.

WhatIf

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

System.Management.Automation.SwitchParameter

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

Объект Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticHeaderSettings. Командлет Set-CsDiagnosticHeaderConfiguration принимает экземпляры объекта параметров диагностических заголовков, переданные по конвейеру.

Командлет Set-CsDiagnosticHeaderConfiguration не возвращает объекты или значения. Вместо этого командлет изменяет существующие экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticHeaderSettings.

 
Показ: