Set-CsAutodiscoverConfiguration

Skype for Business Server 2015
 

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

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

Set-CsAutodiscoverConfiguration [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Set-CsAutodiscoverConfiguration [-Instance <PSObject>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-EnableCertificateProvisioningServiceUrl <$true | $false>] [-ExternalSipClientAccessFqdn <String>] [-ExternalSipClientAccessPort <UInt32>] [-Force <SwitchParameter>] [-WebLinks <PSListModifier>] [-WhatIf [<SwitchParameter>]]

В примере 1 команды добавляют новый URL-адрес (http://LyncDiscover.fabrikam.com) в параметры конфигурации службы автообнаружения, назначенные сайту Redmond. Для этого первая команда примера с помощью командлета New-CsWebLink создает новый URL-адрес службы автообнаружения, и этот URL-адрес сохраняется в переменной $Link1. Вторая команда с помощью командлета Set-CsAutoDiscoverConfiguration добавляет новый URL-адрес ко всем URL-адресам, уже назначенным для этих параметров. Для этого используется параметр WebLinks и значение параметра @{Add=$Link1}.

$Link1 = New-CsWebLink -Token "Fabrikam" -Href "http://LyncDiscover.fabrikam.com"

Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks @{Add=$Link1}

В примере 2 показано, как можно удалить URL-адрес из коллекции параметром конфигурации службы автообнаружения. Для этого первая команда в коллекции получает ссылку на объект удаляемого URL-адреса (URL-адреса, для которого свойство Token имеет значение "Fabrikam"). При этом сначала вызывается командлет Get-CsAutoDiscoverConfiguration , чтобы получить параметры службы автообнаружения для сайта Redmond. Затем коллекция передается командлету Select-Object , который использует параметр ExpandProperty, чтобы "развернуть" свойство WebLinks. (Когда свойство развернуто, Get-CsAutoDiscoverConfiguration получает доступ к отдельным объектам, хранящимся в этом свойстве.) Затем эти объекты WebLinks передаются командлету Where-Object , выбирающему один объект, у которого свойство Token имеет значение "Fabrikam". Этот объект WebLinks сохраняется в переменной $Link1.

После этого вторая команда примера с помощью командлета Set-CsAutoDiscoverConfiguration удаляет объект, хранящийся в $Link1. Для этого в команде используется параметр WebLinks и значение параметра @{Remove=$Link1}.

$Link1 = Get-CsAutoDiscoverConfiguration  -Identity "site:Redmond" | Select-Object -ExpandProperty WebLinks | Where-Object {$_.Token -eq "Fabrikam"}

Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks @{Remove=$Link1}

В примере 3 показано, как можно заменить существующую коллекцию URL-адресов службы автообнаружения одним URL-адресом в данном случае. Для выполнения этой задачи первая команда примера с помощью командлета New-CsWebLink создает новый URL-адрес службы автообнаружения для http://LyncDiscover.contoso.com, который затем сохраняется в переменной $Link2. Вторая команда с помощью командлета Set-CsAutoDiscoverConfiguration и параметра WebLinks удаляет все ранее назначенные сайту Redmond URL-адреса и заменяет их URL-адресом для http://LyncDiscover.contoso.com. Для этого в команде используется метод замены (Replace) вместо метода добавления или удаления (Add or Remove).

$Link2 = New-CsWebLink -Token "Contoso" -Href "http://LyncDiscover.contoso.com"

Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks @{Replace=$Link2}

В примере 4 команда удаляет все URL-адреса службы автообнаружения, назначенные сайту Redmond. Для этого команда присваивает свойству WebLinks нулевое значение, а это, в свою очередь, удаляет все ранее назначенные свойству URL-адреса.

Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks $Null

Клиентские приложения для эффективного использования Skype для бизнеса Server 2015 должны знать расположение ключевых компонентов Skype для бизнеса Server 2015. Например, прошедшие проверку подлинности пользователи должны иметь возможность найти домашний пул; в конце концов, только в нем они могут пройти проверку подлинности. Аналогично пользователи, не прошедшие проверку подлинности, должны быть способны выполнять такие действия, как поиск URL-адреса, для присоединения к конференции.

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

Это особенно верно для ситуаций с использованием раздельных доменов, когда некоторые учетные записи пользователей находятся в локальной версии Skype для бизнеса Server 2015, в то время как другие пользователи имеют учетные записи в Skype для бизнеса Online. В подобных случаях учетные записи пользователей могут располагаться в различных лесах Active Directory. Это может вызвать проблему, например, если располагающийся в США пользователь выполняет вход из Европы, то система должна распознать его лес и направить запрос на вход в соответствующий пул.

Для устранения подобных проблем в накопительном пакете обновления Lync Server за ноябрь 2011 года была предоставлена служба автообнаружения. Если клиентское приложение пытается получить доступ к Skype для бизнеса Server 2015, служба автообнаружения обрабатывает SIP-адрес клиента и перенаправляет запрос в соответствующий пул. Клиентские приложения подключаются к службе автообнаружения, отправляя HTTP-запрос на URL-адрес службы. Администраторы должны настроить эти URL-адреса, чтобы служба автообнаружения работала. (Кроме того, администраторы также должны создать DNS-записи, соответствующие этим URL-адресам.)

URL-адреса службы автообнаружения назначаются в настройках конфигурации службы автообнаружения; эти настройки, в свою очередь, можно применить к глобальной области действия или области действия сайта. При установке Skype для бизнеса Server 2015 создается глобальная коллекция настроек. (Но этой коллекции не назначаются URL-адреса службы автообнаружения). Если одной коллекции настроек автообнаружения недостаточно для ваших нужд, вы можете с помощью командлета New-CsAutoDiscoverConfiguration создать дополнительные настройки конфигурации в области действия сайта. Таким образом, вы можете использовать командлет Set-CsAutoDiscoverConfiguration для добавления или удаления URL-адресов службы автообнаружения из глобальной коллекции или коллекции уровня сайта.

По умолчанию право на локальный запуск командлета Set-CsAutoDiscoverConfiguration имеют члены группы RTCUniversalServerAdmins.

 

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

Confirm

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

System.Management.Automation.SwitchParameter

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

EnableCertificateProvisioningServiceUrl

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

System.Boolean

Если задано значение True (значение по умолчанию), в ответы службы автообнаружения включается URL-адрес службы подготовки сертификатов.

ExternalSipClientAccessFqdn

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

System.String

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

ExternalSipClientAccessPort

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

System.UInt32

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

Force

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

System.Management.Automation.SwitchParameter

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

Уникальный идентификатор для изменяемой коллекции настроек конфигурации автообнаружения. Для изменения глобальной коллекции используйте следующий синтаксис:

-Identity "global"

Для изменения коллекции, настроенной в области действия сайта, используйте синтаксис следующего вида:

-Identity "site:Redmond"

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

Instance

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

AutoDiscoverConfiguration object

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

WebLinks

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

System.Management.Automation.PSListModifier

Коллекция URL-адресов службы автообнаружения. Данные адреса должны быть созданы с помощью командлета New-CsWebLink .

WhatIf

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

System.Management.Automation.SwitchParameter

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

Командлет Set-CsAutoDiscoverConfiguration принимает конвейерные входные данные объекта Microsoft.Rtc.Management.WriteableConfig.Settings.AutoDiscoverConfiguration.AutoDiscoverConfiguration.

Нет. Командлет Set-CsAutoDiscoverConfiguration изменяет экземпляры объекта Microsoft.Rtc.Management.WriteableConfig.Settings.AutoDiscoverConfiguration.AutoDiscoverConfiguration.

 
Показ: