Set-CsXmppAllowedPartner

Skype for Business Server 2015
 

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

Изменяет существующего разрешенного XMPP-партнера. XMPP — это протокол связи открытого стандарта для обмена сообщениями с помощью XML. Разрешенный партнер — это поставщик службы мгновенных сообщений и сведений о присутствии, пользователям которого разрешено обмениваться мгновенными сообщениями и сведениями о присутствии с вашими пользователями Skype для бизнеса Server 2015. Данный командлет впервые появился в Lync Server 2013.

Set-CsXmppAllowedPartner [-Identity <XdsGlobalRelativeIdentity>] <COMMON PARAMETERS>
Set-CsXmppAllowedPartner [-Instance <PSObject>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-AdditionalDomains <PSListModifier>] [-Confirm [<SwitchParameter>]] [-ConnectionLimit <UInt32>] [-Description <String>] [-EnableKeepAlive <$true | $false>] [-Force <SwitchParameter>] [-PartnerType <Federated | PublicVerified | PublicUnverified>] [-ProxyFqdn <String>] [-SaslNegotiation <Required | Optional | NotSupported>] [-SupportDialbackNegotiation <$true | $false>] [-TlsNegotiation <Required | Optional | NotSupported>] [-WhatIf [<SwitchParameter>]]

В примере 1 показана команда, которая отключает согласование обратным вызовом для разрешенного XMPP-партнера contoso.com. Для этого используется параметр SupportDialbackNegotiation, которому присваивается значение False ($False).

Set-CsXmppAllowedPartner -Identity "contoso.com" -SupportDialbackNegotiation $False

В этом примере включается (и является обязательным) согласование по протоколу SASL для всех разрешенных XMPP-партнеров в организации. Сначала используется командлет Get-CsXmppAllowedPartner для получения коллекции всех разрешенных XMPP-партнеров. Затем эта коллекция передается по конвейеру в командлет Set-CsXmppAllowedPartner , который присваивает значение Required свойству SaslNegotiation каждого партнера в коллекции.

Get-CsXmppAllowedPartner | Set-CsXmppAllowedPartner -SaslNegotiation "Required"

В примере 3 для разрешенного XMPP-партнера contoso.com добавляется новый дочерний домен na.contoso.com. Для этого используется параметр AdditionalDomains с синтаксисом @{Add="na.contoso.com"}. Этот синтаксис добавляет домен na.contoso.com к другим доменам, перечисленным в свойстве AdditionalDomains.

Set-CsXmppAllowedPartner -Identity "contoso.com" -AdditionalDomains @{Add="na.contoso.com"}

В примере 4 домен europe.contoso.com удаляется из коллекции дополнительных доменов, назначенных для разрешенного XMPP-партнера contoso.com. Для удаления этого домена используется параметр AdditionalDomains со значением @{Remove="europe.contoso.com"}. Этот синтаксис удаляет домен Europe.contoso.com из свойства AdditionalDomains и не влияет на другие домены, которые также могут храниться в AdditionalDomains.

Set-CsXmppAllowedPartner -Identity "contoso.com" -AdditionalDomains @{Remove="europe.contoso.com"}

В примере 5 показана команда, которая удаляет поддержку дочерних доменов для разрешенного XMPP-партнера contoso.com. Для этого используется параметр AdditionalDomains со значением $Null, который удаляет все домены, содержащиеся в свойстве AdditionalDomains.

Set-CsXmppAllowedPartner -Identity "contoso.com" -AdditionalDomains $Null

Расширенный протокол обмена сообщениями и сведениями о присутствии (XMPP) — это стандартный протокол связи (на основе XML), используемый для передачи сообщений через Интернет. Протокол XMPP изначально назывался Jabber. Он поддерживается рядом приложений для обмена данными и сообщениями через Интернет, включая Google Talk и Facebook Chat.

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

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

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

Панель Панель управления Skype для бизнеса Server: чтобы изменить значения свойств существующего разрешенного XMPP-партнера с помощью панели Панель управления Skype для бизнеса Server, щелкните "Доступ внешних пользователей", "Федеративные XMPP-партнеры" и дважды щелкните партнера, которого необходимо изменить.

 

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

AdditionalDomains

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

System.Management.Automation.PSListModifier

Дополнительные домены XMPP, принадлежащие разрешенному партнеру.

Confirm

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

System.Management.Automation.SwitchParameter

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

ConnectionLimit

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

System.UInt32

Задает максимальное количество одновременных подключений к конкретному партнеру.

Description

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

System.String

Позволяет администраторам добавлять дополнительные текстовые данные, относящиеся к разрешенному протоколом XMPP-партнеру. Например, поле описания может содержать контактные данные партнера.

EnableKeepAlive

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

System.Boolean

Показывает, должен ли XMPP-партнер периодически отправлять пакеты проверки активности для подтверждения активности соединения. Значение по умолчанию True.

Force

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

System.Management.Automation.SwitchParameter

Запрещает на время выполнения команды отображение каких-либо сообщений о некритических ошибках.

Identity

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

Microsoft.Rtc.Management.Xds.XdsGlobalRelativeIdentity

Полное доменное имя изменяемого разрешенного XMPP-партнера (например, fabrikam.com).

Instance

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

System.Management.Automation.PSObject

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

PartnerType

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

Microsoft.Rtc.Management.WritableConfig.Settings.XmppFederation.PartnerType

Задает связь между Skype для бизнеса Server 2015 и XMPP-партнером. Допустимые значения:

* Federated (XMPP-партнер из федеративного домена)

* PublicVerified

* PublicUnverified

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

ProxyFqdn

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

System.String

Полное доменное имя прокси-сервера, используемого XMPP-партнером.

SaslNegotiation

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

Microsoft.Rtc.Management.WritableConfig.Settings.XmppFederation.SaslNegotiation

Означает поддержку протокола SASL, используемого для проверки подлинности сервера.

Допустимые значения:

* Required (должно поддерживаться согласование по протоколам SASL)

* Optional (будет использоваться протокол SASL, если он доступен)

* NotSupported (согласование SASL не будет поддерживаться)

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

SupportDialbackNegotiation

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

System.Boolean

Показывает, будет ли поддерживаться согласование обратным вызовом. Если такое согласование поддерживается, то при обращении сервера A к серверу B связь не устанавливается немедленно. Сначала сервер B пытается проверить удостоверение сервера A посредством обращения к заслуживающему доверия DNS-серверу для получения сведений о домене, к которому принадлежит сервер A.

Стоит отметить, что согласование обратным вызовом не так безопасно, как использование SASL или TLS. В основном подобное согласование применяется в тех случаях, когда нельзя использовать сертификаты для проверки подлинности сервера.

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

TlsNegotiation

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

Microsoft.Rtc.Management.WritableConfig.Settings.XmppFederation.TlsNegotiation

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

Допустимые значения:

* Required (должно поддерживаться согласование по протоколу TLS)

* Optional (будет использоваться протокол TLS, если он доступен)

* NotSupported (согласование TLS не будет поддерживаться)

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

Командлет Set-CsXmppAllowedPartner принимает конвейерные экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Settings.XmppFederation.XmppAllowedPartner#Decorated.

Нет. Командлет Set-CsXmppAllowedPartner изменяет существующие экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Settings.XmppFederation.XmppAllowedPartner#Decorated.

 
Показ: