Compartir a través de

  • Artículo

Get-CsTrustedApplication

 

Última modificación del tema: 2012-03-23

Recupera la configuración de una aplicación de confianza.

Sintaxis

Get-CsTrustedApplication [-Identity <ExternalApplicationIdentity>]

Get-CsTrustedApplication [-Filter <String>]

Get-CsTrustedApplication [-ApplicationId <String>] [-TrustedApplicationPoolFqdn <String>]

Descripción detallada

Una aplicación de confianza es un programa de otro desarrollador que se considera de confianza para ejecutarlo como parte de Microsoft Lync Server 2010, pero que no es un componente integrado en el producto. Este cmdlet permite recuperar la configuración de puerto y GRUU (Globally Routable User Agent URI) de una o varias aplicaciones de confianza.

Al usar este cmdlet para recuperar una única aplicación de confianza, es necesario especificar un valor para el parámetro Identity. El valor Identity es el nombre de domino completo (FQDN) del grupo de servidores en el que se hospeda la aplicación, seguido de una barra (/) y, a continuación, el identificador de la aplicación. Por ejemplo, TrustPool.litwareinc.com/tapp2, "TrustPool.litwareinc.com" es el nombre de dominio completo del grupo de servidores y "tapp2" es el identificador de la aplicación. Al recuperar una aplicación llamando a este cmdlet, verá un identificador similar a éste: TrustPool.litwareinc.com/urn:application:tapp2. Fíjese en que se incluye el prefijo urn:application: antes del nombre de la aplicación (tapp2). Aunque este prefijo forma parte de la identidad, no es necesario al especificar el valor del parámetro Identity.

Quién puede ejecutar este cmdlet: de forma predeterminada, están autorizados para ejecutar el cmdlet Get-CsTrustedApplication localmente los miembros de los siguientes grupos: RTCUniversalUserAdmins, RTCUniversalServerAdmins y RTCUniversalReadOnlyAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluidos los roles de RBAC personalizados que haya creado), ejecute el siguiente comando en el símbolo del sistema de Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

ExternalApplicationIdentity

Identificador único de la aplicación de confianza que se quiere recuperar. Los valores de Identity deben especificarse con formato <nombre de dominio completo del grupo de servidores>/<identificador de la aplicación>, donde el nombre de dominio es el nombre de dominio completo del grupo de servidores en el que reside la aplicación, y el identificador de la aplicación es el nombre del programa. Si especifica el valor Identity, no puede especificar el valor ApplicationID ni TrustedApplicationPoolFqdn.

Filter

Opcional

Cadena de caracteres

Cadena de caracteres que incluye caracteres comodín que permiten recuperar aplicaciones de confianza a partir de valores de Identity que coincidan con la cadena con caracteres comodín especificada. Las identidades contienen el nombre de dominio completo del grupo de aplicaciones de confianza, seguido de una barra (/), seguido del identificador de la aplicación. El valor Filter puede coincidir con cualquier parte del valor Identity, tanto el nombre de dominio completo como el identificador de la aplicación.

ApplicationId

Opcional

Cadena de caracteres

El nombre de la aplicación. Puede incluir el prefijo del id. de aplicación, pero no es necesario. Por ejemplo, los valores de ApplicationId de urn:application:tapp1 y tapp1 devolverán la misma aplicación. Si especifica un valor de ApplicationId, no puede especificar un valor de Identity, pero debe especificar un valor para el parámetro TrustedApplicationPoolFqdn.

TrustedApplicationPoolFqdn

Opcional

Cadena de caracteres

Nombre de dominio completo del grupo de aplicaciones de confianza en el que se alojará la aplicación. Si especifica un valor de TrustedApplicationPoolFqdn, no puede especificar un valor de Identity, pero debe especificar un valor para el parámetro ApplicationID.

Tipos de entrada

Ninguno.

Tipos de valores devueltos

Devuelve un objeto de tipo Microsoft.Rtc.Management.Xds.DisplayTrustedApplication.

Ejemplo

-------------------------- Ejemplo 1 ------------------------

Get-CsTrustedApplication

En este ejemplo se recupera información sobre todas las aplicaciones de confianza definidas en la implementación de Lync Server 2010.

-------------------------- Ejemplo 2 ------------------------

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

El Ejemplo 2 recupera la aplicación de confianza con el valor de Identity TrustPool.litwareinc.com/urn:application:tapp2. Fíjese en que no se incluye el prefijo "urn:application:", Get-CsTrustedApplication agrega el prefijo automáticamente y recupera la aplicación correspondiente.

-------------------------- Ejemplo 3 ------------------------

Get-CsTrustedApplication -Filter *trust*

El Ejemplo 3 recupera todas las aplicaciones de confianza con identidades que coincidan con la cadena con caracteres comodín especificada como valor Filter. En este caso se usa el valor *trust* para Filter, de modo que el comando recuperará todas las aplicaciones de confianza que contengan la cadena de caracteres "trust" en la identidad. La cadena de caracteres puede encontrarse en cualquier parte del valor Identity, el nombre de dominio completo del grupo de servidores o el identificador de la aplicación. Este comando recupera aplicaciones con identidades como TrustedPool.litwareinc.com/urn:application:application1, Pool1.litwareinc.com/urn:application:trustedapp y Pool1.litwareinc.com/urn:application:trust.

-------------------------- Ejemplo 4 ------------------------

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

El Ejemplo 4 devuelve los mismos resultados que el Ejemplo 2 (en el que se específica el valor Identity como único parámetro). La única diferencia entre los dos ejemplos es que el Ejemplo 2 recupera la aplicación de confianza a partir del valor Identity, que consiste en el nombre de dominio completo del grupo de confianza seguido del identificador de la aplicación. En este ejemplo, el identificador de la aplicación y el nombre de domino completo del grupo de confianza se especifican como valores de dos parámetros independientes: ApplicationId y TrustedApplicationPoolFqdn.

-------------------------- Ejemplo 5 ------------------------

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

El Ejemplo 5 recupera todas las aplicaciones de confianza del grupo TrustPool.litwareinc.com. Para ello, primero llama al cmdlet Get-CsTrustedApplication. Se devuelve una recopilación de todas las aplicaciones de confianza definidas en la implementación de Lync Server. Esta recopilación se transfiere al cmdlet Where-Object, que la revisa elemento a elemento para detectar los que tienen un valor de TrustedApplicationPoolFqdn igual a (-eq) TrustPool.litwareinc.com.