Get-CsDiagnosticHeaderConfiguration

Skype for Business Server 2015
 

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

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

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

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

Get-CsDiagnosticHeaderConfiguration

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

Get-CsDiagnosticHeaderConfiguration -Identity site:Redmond

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

Get-CsDiagnosticHeaderConfiguration -Filter "service:*"

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

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

Команда, показанная в примере 5, возвращает сведения о параметрах конфигурации диагностических заголовков, которые удовлетворяют как минимум одному из следующих критериев: 1) свойство SendToExternalNetworks равно True; 2) свойство SendToOutsideUnauthenticatedUsers равно True. Для этого команда сначала использует командлет Get-CsDiagnosticHeaderConfiguration , чтобы получить коллекцию всех параметров диагностических заголовков, использующихся в настоящий момент. Эта коллекция передается в командлет Where-Object , который выбирает те параметры, у которых свойство SendToExternalNetworks и (или) свойство SendToOutsideUnauthenticatedUsers равно True.

Оператор -or указывает, что для возврата параметры должны удовлетворять только одному из заданных критериев. Если необходимо, чтобы параметры удовлетворяли обоим критериям, используйте оператор -and:

Where-Object {$_.SendToExternalNetworks -eq $True -and $_.SendToOutsideUnauthenticatedUsers -eq $True}

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

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

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

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

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

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

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

 

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

Filter

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

System.String

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

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

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

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

LocalStore

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

System.Management.Automation.SwitchParameter

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

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

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

 
Показ: