Set-CsSimpleUrlConfiguration

Skype for Business Server 2015
 

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

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

Set-CsSimpleUrlConfiguration [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Set-CsSimpleUrlConfiguration [-Instance <PSObject>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-SimpleUrl <PSListModifier>] [-Tenant <Guid>] [-WhatIf [<SwitchParameter>]]

Команда, представленная в примере 1, удаляет все простые URL-адреса с сайта Redmond, но не удаляет действительный набор простых URL-адресов. (Набор будет по-прежнему существовать, но не будет содержать каких-либо URL-адресов). При этом команда использует параметр SimpleUrl и задает для него нулевое значение ($Null). Это приводит к удалению всех простых URL-адресов из набора.

Set-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl $Null

В примере 2 представлен процесс добавления нового URL-адреса в существующий набор простых URL-адресов. Сначала первая команда в примере использует командлет New-CsSimpleUrlEntry для создания записи URL-адреса, указывающей на https://meet.fabrikam.com; эта запись URL-адреса хранится в переменной с именем $urlEntry.

Во второй команде командлет New-CsSimpleUrl используется для создания экземпляра простого URL-адреса, хранящегося только в памяти. В этом примере для компонента URL-адреса установлено значение Meet; для домена задано значение fabrikam.com; для ActiveUrl задано значение https://meet.fabrikam.com; для свойства SimpleUrl задано значение $urlEntry (при этом $urlEntry — это запись URL, созданная в первой команде).

После создания URL-адреса (и его сохранения в ссылке на объект $simpleUrl) последняя команда в данном примере добавляет новый URL-адрес в набор простых URL-адресов для сайта Redmond. Это выполняется с помощью командлета Set-CsSimpleUrlConfiguration , параметра SimpleUrl и значения параметра @{Add=$simpleUrl}. В результате использования этого синтаксиса URL-адрес, сохраненный в ссылке на объект $simpleUrl, добавляется в свойство SimpleUrl.

$urlEntry = New-CsSimpleUrlEntry -Url "https://meet.fabrikam.com"
$simpleUrl = New-CsSimpleUrl -Component "meet" -Domain "fabrikam.com" -SimpleUrlEntry $urlEntry -ActiveUrl "https://meet.fabrikam.com"

Set-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl @{Add=$simpleUrl}

Команды, представленные в примере 3, показывают, каким образом можно удалить один URL-адрес из набора простых URL-адресов. Так как командлет Set-CsSimpleUrlConfiguration должен работать с объектами URL-адресов, пример начинается с создания нового объекта, который содержит те же самые значения свойств, что и удаляемый URL-адрес. При этом первая команда использует командлет New-CsSimpleUrlEntry для создания записи URL-адреса, которая указывает на https://meet.fabrikam.com; этот URL-адрес хранится в переменной с именем $urlEntry.

После создания записи URL-адреса вторая команда использует командлет New-CsSimpleUrl для создания в памяти экземпляра простого URL-адреса. В этом примере для компонента URL-адреса установлено значение Meet; для домена задано значение fabrikam.com; для ActiveUrl задано значение https://meet.fabrikam.com; для свойства SimpleUrl задано значение $urlEntry (при этом $urlEntry — это запись URL, созданная в первой команде). Это приводит к созданию в памяти URL-адреса ($simpleUrl), который обладает теми же значениями свойств, что и удаляемый URL-адрес.

Последняя команда в примере затем удаляет URL-адрес из набора простых URL-адресов сайта Redmond. Для этого используется командлет Set-CsSimpleUrlConfiguration , параметр SimpleUrl и значение параметра @{Remove=$simpleUrl}. В результате использования этого синтаксиса URL-адрес, сохраненный в ссылке на объект в $simpleUrl, просто удаляется из свойства SimpleUrl.

$urlEntry = New-CsSimpleUrlEntry -Url "https://fabrikam.vdomain.com"
$simpleUrl = New-CsSimpleUrl -Component "meet" -Domain "fabrikam.com" -SimpleUrlEntry $urlEntry -ActiveUrl "https://meet.fabrikam.com"

Set-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl @{Remove=$simpleUrl}

В Microsoft Office Communications Server 2007 R2 для собраний используются URL-адреса следующего вида:

https://imdf.litwareinc.com/Join?uri=sip%3Akenmyer%40litwareinc.com%3Bgruu%3Bopaque%3Dapp%3Aconf%3Afocus%3Aid%3A125f95a0b0184dcea706f1a0191202a8&key=EcznhLh5K5t

Однако подобные URL-адреса не являются интуитивно понятными, и их довольно сложно передавать другим пользователям. Простые URL-адреса, реализованные в Microsoft Lync Server 2010, помогают избежать возникновения подобных проблем за счет предоставления пользователям URL-адресов в следующем формате:

https://meet.litwareinc.com/kenmyer/071200

Простые URL-адреса являются оптимизированным вариантом URL-адресов, используемых в предыдущей версии Office Communications Server. Однако простые URL-адреса не создаются автоматически; вместо этого необходимо настроить URL-адреса вручную. Кроме того, необходимо выполнить такие действия, как создание записей в службе доменных имен (DNS) для каждого URL-адреса; настройка правил обратного прокси-сервера для внешнего доступа; добавление простых URL-адресов для сертификатов сервера переднего плана и т. д.

Skype для бизнеса Server 2015 позволяет создавать три различных простых URL-адреса:

Meet — используется для собраний. Для каждого домена SIP требуется по крайней мере один URL-адрес Meet.

Admin — используется для указания Панель управления Skype для бизнеса Server администраторам.

Dialin — используется для веб-страницы конференц-связи с телефонным подключением.

Простые URL-адреса хранятся в наборе конфигураций простых URL-адресов. При установке Skype для бизнеса Server 2015 создается глобальный набор; можно также создать пользовательские наборы в области сайта. Это предоставляет возможность использования различных простых URL-адресов на каждом сайте.

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

Добавление простых URL-адресов в набор — это достаточно несложная процедура. Сначала необходимо использовать командлеты New-CsSimpleUrl и New-CsSimpleUrlEntry для создания URL-адреса только в памяти. Затем с помощью команды Add добавьте новый URL-адрес в существующий набор. Кроме того, можно использовать метод Replace для замены существующих URL-адресов новым адресом.

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

После обновления набора простых URL-адресов необходимо снова запустить командлет Enable-CsComputer .

 

Параметр Применение Тип Описание

Confirm

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

System.Management.Automation.SwitchParameter

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

Force

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

System.Management.Automation.SwitchParameter

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

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

-Identity global

Чтобы изменить набор из области сайта, используйте синтаксис, аналогичный следующему:

-Identity "site:Redmond"

Если этот параметр не задан, изменяется глобальный набор.

Instance

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

Объект SimpleUrlConfiguration

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

SimpleUrl

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

System.Management.Automation.PSListModifier

Простые URL-адреса, настроенные для данного набора. Эти URL-адреса должны создаваться с помощью командлетов New-SimpleUrl и New-SimpleUrlEntry .

Tenant

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

System.Guid

Глобальный уникальный идентификатор (GUID) учетной записи клиента Skype для бизнеса Online, параметры конфигурации простых URL-адресов которой необходимо изменить. Например:

-Tenant "38aad667-af54-4397-aaa7-e94c79ec2308"

Идентификатор каждого из клиентов можно получить с помощью следующей команды:

Get-CsTenant | Select-Object DisplayName, TenantID

WhatIf

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

System.Management.Automation.SwitchParameter

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

Объект Microsoft.Rtc.Management.WritableConfig.Settings.SimpleUrl.SimpleUrlConfiguration. Командлет Set-CsSimpleUrlConfiguration принимает передаваемые экземпляры объекта конфигурации простых URL-адресов.

 
Показ: