Get-CsTrustedApplication

Skype for Business Server 2015
 

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

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

Get-CsTrustedApplication [-ApplicationId <String>] [-TrustedApplicationPoolFqdn <String>] <COMMON PARAMETERS>
Get-CsTrustedApplication [-Identity <ExternalApplicationIdentity>] <COMMON PARAMETERS>
Get-CsTrustedApplication [-Filter <String>] <COMMON PARAMETERS>
COMMON PARAMETERS:

В этом примере извлекаются сведения о всех доверенных приложениях, заданных в развертывании Skype для бизнеса Server 2015.

Get-CsTrustedApplication

В примере 2 извлекается доверенное приложение с удостоверением TrustPool.litwareinc.com/urn:application:tapp2. Следует отметить, что префикс urn:application: можно не указывать, поскольку командлет Get-CsTrustedApplication автоматически добавляет этот префикс и извлекает правильное приложение.

Get-CsTrustedApplication -Identity TrustPool.litwareinc.com/tapp2

В примере 3 извлекаются все доверенные приложения, удостоверения которых соответствуют строке с подстановочными знаками, заданной в качестве значения свойства Filter. В данном случае Filter имеет значение *trust*, следовательно команда извлечет все доверенные приложения, удостоверение которых в любом месте включает строку символов “trust”. Эта строка может содержаться в любой части удостоверения, полного доменного имени пула или идентификатора приложения. Поэтому данная команда будет извлекать доверенные приложения с такими удостоверениями, как TrustedPool.litwareinc.com/urn:application:application1, Pool1.litwareinc.com/urn:application:trustedapp и Pool1.litwareinc.com/urn:application:trust.

Get-CsTrustedApplication -Filter *trust*

В примере 4 извлекаются те же результаты, что и в примере 2 (в котором удостоверение указывается в качестве единственного параметра). Различие между этими примерами состоит в том, что в примере 2 доверенные приложения извлекаются на основе удостоверения, которое состоит из полного доменного имени доверенного пула, за которым следует идентификатор приложения. В этом примере идентификатор приложения и полное доменное имя доверенного пула вводятся как значения двух разных параметров, ApplicationId и TrustedApplicationPoolFqdn.

Get-CsTrustedApplication -ApplicationId tapp2 -TrustedApplicationPoolFqdn TrustPool.litwareinc.com

В примере 5 извлекаются все доверенные приложения в пуле TrustPool.litwareinc.com. Сначала вызывается командлет Get-CsTrustedApplication , который возвращает коллекцию всех доверенных приложений, заданных в развертывании Skype для бизнеса Server 2015. Затем эта коллекция передается в командлет Where-Object , который просматривает эту коллекцию элемент за элементом, чтобы найти те доверенные приложения, свойство TrustedApplicationPoolFqdn которых имеет значение (-eq) TrustPool.litwareinc.com.

Get-CsTrustedApplication | Where-Object {$_.TrustedApplicationPoolFqdn -eq "TrustPool.litwareinc.com"}

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

При использовании этого командлета для извлечения одного доверенного приложения необходимо предоставить значение для параметра Identity. Параметр Identity представляет собой полное доменное имя пула, за которым через косую черту (/) следует идентификатор приложения, например TrustPool.litwareinc.com/tapp2, где TrustPool.litwareinc.com — это полное доменное имя пула, а tapp2 — идентификатор приложения. Следует отметить, что извлекая приложение с помощью этого командлета, вы увидите идентификатор, который выглядит примерно следующим образом: TrustPool.litwareinc.com/urn:application:tapp2. Обратите внимание на префикс urn:application: перед именем приложения (tapp2). Хотя этот префикс является частью удостоверения, его не нужно указывать в значении для параметра Identity.

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

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

 

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

ApplicationId

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

System.String

Имя приложения. Оно может включать префикс для идентификатора приложения, но это не обязательно. Например, при указании значений urn:application:tapp1 и tapp1 для параметра ApplicationId будет извлекаться одно и то же приложение. Если указывается значение для параметра ApplicationId, то нельзя задавать значение для Identity, но необходимо задать значение для параметра TrustedApplicationPoolFqdn.

Filter

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

System.String

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

Identity

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

Microsoft.Rtc.Management.Xds.ExternalApplicationIdentity

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

TrustedApplicationPoolFqdn

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

System.String

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

Возвращает объект типа Microsoft.Rtc.Management.Xds.DisplayTrustedApplication.

 
Показ: