Remove-CsDiagnosticHeaderConfiguration

Skype for Business Server 2015
 

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

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

Remove-CsDiagnosticHeaderConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

В примере 1 удаляются параметры конфигурации диагностических заголовков, которые имеют удостоверение site:Redmond.

Remove-CsDiagnosticHeaderConfiguration -Identity site:Redmond

Команда, показанная в примере 2, удаляет все параметры конфигурации диагностических заголовков, которые применяются на уровне службы. Для этого сначала вызывается командлет Get-CsDiagnosticHeaderConfiguration с параметром Filter. Значение фильтра "service:*" ограничивает извлекаемые данные теми, удостоверение которых начинается с символов "service:". Затем эта отфильтрованная коллекция передается в командлет Remove-CsDiagnosticHeaderConfiguration , который удаляет каждый элемент в коллекции.

Get-CsDiagnosticHeaderConfiguration -Filter service:* | Remove-CsDiagnosticHeaderConfiguration

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

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

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

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

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

Все созданные новые коллекции (на уровне узла или на уровне службы) впоследствии можно удалить с помощью командлета Remove-CsDiagnosticHeaderConfiguration . Этот командлет можно также использовать для глобальной коллекции. Однако в этом случае глобальная коллекция не будет удалена, поскольку это невозможно сделать. Вместо удаления будут восстановлены значения по умолчанию тех двух свойств, которые имеются в глобальной коллекции — SendToExternalNetworks и SendToOutsideUnauthenticatedUsers (в обоих случаях это значения False).

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

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

 

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

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

Командлет Remove-CsDiagnosticHeaderConfiguration можно также выполнять для глобальных параметров конфигурации; в этом случае используйте следующий синтаксис: –Identity global. Обратите внимание, что глобальные параметры в действительности не удаляются, вместо удаления восстанавливаются значения по умолчанию свойств, найденных в глобальных параметрах.

Confirm

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

System.Management.Automation.SwitchParameter

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

Force

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

System.Management.Automation.SwitchParameter

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

 
Показ: