New-CsTrustedApplication

Skype for Business Server 2015
 

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

Добавляет доверенное приложение в пул. Данный командлет впервые появился в Lync Server 2010.

New-CsTrustedApplication -ApplicationId <String> -TrustedApplicationPoolFqdn <String> <COMMON PARAMETERS>
New-CsTrustedApplication [-Identity <ExternalApplicationIdentity>] <COMMON PARAMETERS>
COMMON PARAMETERS: -Port <Int32> [-Confirm [<SwitchParameter>]] [-EnableTcp <SwitchParameter>] [-Force <SwitchParameter>] [-LegacyApplicationName <String>] [-WhatIf [<SwitchParameter>]]

Этот пример создает доверенное приложение с идентификатором tapp1. Параметр TrustedApplicationPoolFqdn используется для обозначения пула доверенных приложений, в который будет добавлено это приложение. В данном случае это пул с полным доменным именем TrustPool.litwareinc.com. Также необходимо указать порт приложения. В этом примере используется порт 6000. Учтите, что при запуске этого командлета с параметрами ApplicationId и TrustedApplicationPoolFqdn, будет автоматически создано удостоверение Identity, которое затем можно использовать для извлечения, изменения или удаления этого приложения.

New-CsTrustedApplication -ApplicationId tapp1 -TrustedApplicationPoolFqdn TrustPool.litwareinc.com -Port 6000

В этом примере создается доверенное приложение с удостоверением TrustPool.litwareinc.com/tapp2 и портом 6100. Обратите внимание на формат удостоверения. Это значение должно быть указано в формате <полное_доменное_имя_пула_доверенных_приложений>/<идентификатор_приложения>.

New-CsTrustedApplication -Identity TrustPool.litwareinc.com/tapp2 -Port 6100

Доверенное приложение — это приложение, разработанное сторонним производителем, которое получает статус доверенного для выполнения в Skype для бизнеса Server 2015, но которое не является встроенной частью продукта. Этот командлет добавляет доверенное приложение в пул доверенных приложений и назначает порт внешней службе, которая запускает приложение.

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

Если этот командлет используется для создания доверенного приложения необходимо указать значение либо для параметра Identity, либо для параметра ApplicationID и TrustedApplicationPoolFqdn. Значением Identity является TrustedApplicationPoolFqdn, за которым следует косая черта (/) и ApplicationID. Например, TrustPool.litwareinc.com/tapp2, где TrustPool.litwareinc.com — это TrustedApplicationPoolFqdn, а tapp2 — это ApplicationID.

Учтите, что при вводе идентификатора приложения (как части параметра Identity или в параметре ApplicationID) необходимо ввести только имя приложения. Однако к полному идентификатору приложения будет автоматически добавлен префикс urn:application:. Например, если ввести значение tapp2 для параметра ApplicationID, то этот идентификатор будет храниться как urn:application:tapp2. Аналогично, если ввести для Identity значение TrustPool.litwareinc.com/tapp2, оно будет храниться в системе как TrustPool.litwareinc.com/urn:application:tapp2.

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

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

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsTrustedApplication\b"}

 

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

ApplicationId

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

System.String

Имя приложения. Это должна быть уникальная строка в пуле, заданном в параметре TrustedApplicationPoolFqdn. Эта строка не может содержать пробелы. Если указать значение для параметра ApplicationId, необходимо также задать значение для TrustedApplicationPoolFqdn. Нельзя указывать одновременно параметр ApplicationId и Identity.

Port

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

System.Int32

Номер порта, на котором будет работать приложение. Порт должен быть уникальным в указанном пуле. Другими словами, нельзя задавать другие приложения в указанном пуле, которые используют этот же порт.

TrustedApplicationPoolFqdn

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

System.String

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

Confirm

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

System.Management.Automation.SwitchParameter

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

EnableTcp

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

System.Management.Automation.SwitchParameter

Указывает, что доверенное приложение будет использовать протокол TCP. Используйте этот параметр, только если доверенное приложение не является приложением Microsoft Unified Communications Managed API (UCMA). Это связано с тем, что приложения UCMA поддерживают только протокол MTLS. Если не указать параметр Force с параметром EnableTcp, отобразится запрос на подтверждение перед созданием доверенного приложения.

Force

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

System.Management.Automation.SwitchParameter

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

Identity

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

Microsoft.Rtc.Management.Xds.ExternalApplicationIdentity

Уникальный идентификатор доверенного приложения в пуле. Значения параметра Identity необходимо вводить в формате <полное_доменное_имя_пула_доверенных_приложений>/<идентификатор_приложения>, где полным доменным именем пула является имя пула, в котором размещено приложение, а идентификатор приложения — это имя приложения. Значение идентификатора приложения должно быть уникальным в указанном пуле.

Если вводится параметр Identity, вы не можете указывать значения параметров ApplicationId и TrustedApplicationPoolFqdn.

LegacyApplicationName

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

System.String

Используйте этот параметр, только если приложение переносится из развертывания Microsoft Office Communications Server 2007 R2. Это значение должно совпадать с типом GRUU версии Office Communications Server 2007 R2 приложения, чтобы они вместе работали.

Учтите, что в большинстве случаев установки параметра ApplicationId как типа GRUU достаточно для работы приложений. Но если тип GRUU из приложения Office Communications Server 2007 R2 содержит символы, недопустимые в ApplicationId, это значение необходимо указать в параметре LegacyApplicationName.

Если не указать значение для этого параметра, автоматически вставляется значение идентификатора приложения (без префикса urn:application:).

WhatIf

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

System.Management.Automation.SwitchParameter

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

Создает объект типа Microsoft.Rtc.Management.Xds.DisplayTrustedApplication.

 
Показ: