Publish-CsTopology

Skype for Business Server 2015
 

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

Публикует топологию Skype для бизнеса Server 2015, извлеченную с помощью командлета Get-CsTopology . Данный командлет впервые появился в Lync Server 2010.

Publish-CsTopology -FileName <String> <COMMON PARAMETERS>
Publish-CsTopology -Document <XElement> <COMMON PARAMETERS>
Publish-CsTopology -FinalizeUninstall <SwitchParameter> <COMMON PARAMETERS>
COMMON PARAMETERS: [-BackupFileName <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>] [-WhatIf [<SwitchParameter>]]

Команды, показанные в примере 1, извлекают и повторно публикуют текущую топологию. Для выполнения этих задач первая команда в примере с помощью командлета Get-CsTopology и параметра AsXml извлекает текущую топологию; затем с помощью символа перенаправления > в Windows PowerShell полученные данные сохраняются в файл с именем C:\Topologies\Topology.xml. (Также отметим, что для преобразования полученной топологии в строковое значение используется метод ToString.) Вторая команда в примере с помощью командлета Publish-CsTopology повторно публикует только что извлеченную топологию.

(Get-CsTopology -AsXml).ToString() > C:\Topologies\Topology.xml 
Publish-CsTopology -FileName "C:\Topologies\Topology.xml"

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

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

Командлет Publish-CsTopology больше не рекомендуется использовать для публикации топологий, созданных с помощью построителя топологий; публиковать топологии следует с помощью построителя топологий, выполняя действия, описанные в предыдущем параграфе. Это объясняется тем, что теперь построитель топологий использует формат XML-файлов построителя топологий (TBXML); этот формат файлов невозможно публиковать с помощью командлета Publish-CsTopology . С помощью командлета Publish-CsTopology можно только повторно публиковать топологию, полученную с помощью командлета Get-CsTopology . После публикации топологии таким образом потребуется перенастроить простые URL-адреса.

Кто может выполнять этот командлет. По умолчанию право выполнения командлета Publish-CsTopology имеют члены следующей группы: RTCUniversalServerAdmins. Однако если разрешения для настройки не делегируются, то для выполнения командлета Publish-CsTopology необходимо быть администратором домена. Чтобы дать группе RTCUniversalServerAdmins право фактического использования командлета Publish-CsTopology , следует выполнить командлет Grant-CsSetupPermission для каждого контейнера Active Directory, содержащего компьютеры, на которых работают службы Skype для бизнеса Server 2015. Обратите внимание, что эти ограничения также относятся к включению топологии с помощью построителя топологий. Если разрешения не делегированы с помощью командлета Set-CsSetupPermission , то публиковать топологию с помощью построителя топологий сможет только администратор домена.

 

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

Document

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

System.Xml.Linq.XElement

Позволяет публиковать XML-элемент, а не XML-файл. Данный XML-элемент должен быть настроен как объект System.XML.Linq.XElement.

FileName

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

System.String

Полный путь к XML-файлу, содержащему новые сведения о топологии.

FinalizeUninstall

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

System.Management.Automation.SwitchParameter

Используется только при удалении Skype для бизнеса Server 2015. После удаления центрального сервера управления используйте командлет Publish-CsTopology и параметр FinalizeUninstall для публикации пустой топологии. Помимо прочего это удаляет все записи Active Directory для центрального сервера управления.

BackupFileName

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

System.String

Полный путь к файлу резервной копии, создаваемому автоматически при выполнении командлета Publish-CsTopology . Если этот параметр не указан, то командлет Publish-CsTopology будет создавать файл резервной копии в папке Temp (%temp%) с именем, подобным следующему: Publish-CsTopology-Backup-[2010_10_01][08_30_00]. В этом имени файла 2010_10_01 указывает дату публикации: год (2010), месяц (10) и день (01). Кроме того, 08_30_00 указывает время публикации: часы (08), минуты (30) и секунды (00).

Confirm

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

System.Management.Automation.SwitchParameter

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

Force

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

System.Management.Automation.SwitchParameter

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

GlobalCatalog

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

Microsoft.Rtc.Management.Deploy.Fqdn

Полное доменное имя сервера глобального каталога в домене. Этот параметр не требуется, если командлет Publish-CsTopology запускается на компьютере с учетной записью в вашем домене.

GlobalSettingsDomainController

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

Microsoft.Rtc.Management.Deploy.Fqdn

Полное доменное имя (FQDN) контроллера домена, на котором хранятся глобальные параметры. Если глобальные параметры хранятся в контейнере System в доменных службах Active Directory, этот параметр должен указывать на корневой контроллер домена. Если глобальные параметры хранятся в контейнере Configuration, можно использовать любой контроллер домена, а также не указывать данный параметр.

Report

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

System.String

Позволяет указать путь к файлу для файла журнала, созданного при выполнении командлета. Например: -Report "C:\Logs\Publish_Topology.html"

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

Нет. Вместо этого командлет Publish-CsTopology публикует экземпляры объекта Microsoft.Rtc.Management.Deploy.Internal.DefaultTopology.

 
Показ: