New-CsTrustedApplication
Última modificación del tema: 2012-03-26
Agrega una aplicación de confianza a un grupo.
Sintaxis
New-CsTrustedApplication -ApplicationId <String> -Port <Int32> -TrustedApplicationPoolFqdn <String> [-Confirm [<SwitchParameter>]] [-EnableTcp <SwitchParameter>] [-Force <SwitchParameter>] [-LegacyApplicationName <String>] [-WhatIf [<SwitchParameter>]]
New-CsTrustedApplication [-Identity <ExternalApplicationIdentity>] -Port <Int32> [-Confirm [<SwitchParameter>]] [-EnableTcp <SwitchParameter>] [-Force <SwitchParameter>] [-LegacyApplicationName <String>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Una aplicación de confianza es una aplicación desarrollada por otro fabricante, a la que se le da estado de confianza para ejecutarla como parte de Microsoft Lync Server 2010, pero que no constituye una parte integrada del producto. Este cmdlet agrega una aplicación de confianza a un grupo de aplicaciones de confianza y le asigna un puerto al servicio externo que ejecuta la aplicación.
Las aplicaciones de confianza deben estar asociadas con los URI de agentes de usuario enrutables globalmente (GRUU), tanto los GRUU del servicio como los GRUU del equipo. Este cmdlet genera automáticamente estos valores, según los equipos y los servicios asociados al grupo en el que se aloja esta aplicación.
Al usar este cmdlet para crear una aplicación de confianza, debe proporcionar valores para el parámetro Identity o bien para los parámetros ApplicationID y TrustedApplicationPoolFqdn. El parámetro Identity es TrustedApplicationPoolFqdn, seguido de una barra (/) y de ApplicationID. Por ejemplo: TrustPool.litwareinc.com/tapp2. Aquí, TrustPool.litwareinc.com es la parte TrustedApplicationPoolFqdn y tapp2 es la parte ApplicationID.
Tenga en cuenta que al escribir un Id. de aplicación (ya sea como parte del parámetro Identity o del parámetro ApplicationID) solo debe escribir el nombre de la aplicación. Sin embargo, el Id. de aplicación completo lleva, automáticamente, la cadena urn:application: como prefijo. Por ejemplo, si escribe el valor tapp2 en ApplicationID, dicho Id. se almacenará como urn:application:tapp2. De manera similar, si escribe un parámetro Identity igual a TrustPool.litwareinc.com/tapp2, este se almacenará en el sistema como TrustPool.litwareinc.com/urn:application:tapp2.
Al especificar el valor Port mediante este cmdlet, no se abre el puerto. Debe abrir el puerto en el firewall de Windows y los demás firewall corporativos a fin de que la aplicación de confianza haga contacto con las redes fuera del firewall.
Quiénes pueden ejecutar este cmdlet: De manera predeterminada, los miembros de los siguientes grupos están autorizados para ejecutar el cmdlet New-CsTrustedApplication en forma local: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsTrustedApplication\b"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
ExternalApplicationIdentity |
Identificador único de la aplicación de confianza en el grupo. Los valores del parámetro Identity deben escribirse siguiendo el formato <pool FQDN>/<application ID>, donde pool FQDN es el nombre de dominio completo (FQDN) del grupo en el que reside la aplicación, y application ID es el nombre de la aplicación. En un grupo determinado, el Id. de aplicación debe ser único. Si escribe un valor para el parámetro Identity, no pude especificar valores para los parámetros ApplicationId ni TrustedApplicationPoolFqdn. |
ApplicationId |
Requerido |
Cadena de caracteres |
El nombre de la aplicación. Debe ser una cadena que sea única dentro del grupo que se especifica en el parámetro TrustedApplicationPoolFqdn. La cadena no debe contener espacios. Si suministra un valor para ApplicationId, también deberá hacerlo para el parámetro TrustedApplicationPoolFqdn. No es posible especificar un valor para ApplicationId y una identidad. |
Port |
Requerido |
Int32 |
El número de puerto en el que se ejecutará la aplicación. En un grupo determinado, el puerto debe ser único. En otras palabras, en el grupo especificado no se puede definir ninguna otra aplicación que use el mismo puerto. |
TrustedApplicationPoolFqdn |
Requerido |
Cadena de caracteres |
El FQDN del grupo de aplicaciones de confianza en el cual residirá la aplicación. Si suministra un valor para TrustedApplicationPoolFqdn también deberá hacerlo para ApplicationId, pero no podrá suministrar un valor para el parámetro Identity. |
EnableTcp |
Opcional |
Parámetro modificador |
Especifica que la aplicación de confianza usará Protocolo de control de transmisión (TCP). Use este parámetro solo si la aplicación de confianza si no es una aplicación de Microsoft Unified Communications Managed API (UCMA). Esto se debe a que las aplicaciones de UCMA admiten solamente el protocolo mutuo de seguridad de la capa de transporte (MTLS). Si no especifica el parámetro Force con el parámetro EnableTcp, recibirá una solicitud de confirmación antes de crear la nueva aplicación de confianza. |
LegacyApplicationName |
Opcional |
Cadena de caracteres |
Use este parámetro sólo si se migra la aplicación desde una implementación de Microsoft Office Communications Server 2007 R2. Este valor debe ser igual al tipo GRUU de la versión Office Communications Server 2007 R2 de la aplicación para que las dos trabajen juntas. Tenga en cuenta que en la mayoría de los casos será suficiente configurar el parámetro ApplicationId igual al tipo GRUU para que las aplicaciones trabajen juntas. Sin embargo, si el tipo GRUU de la aplicación Office Communications Server 2007 R2 contiene caracteres no válidos en ApplicationId, ese valor deberá ser proporcionado en el parámetro LegacyApplicationName. Si no especifica un valor para este parámetro, el valor del identificador de la aplicación se insertará automáticamente (sin urn:application: prefix). |
Force |
Opcional |
Parámetro modificador |
Suprime las solicitudes de confirmación que, de lo contrario, se mostrarían antes de realizar cambios. |
WhatIf |
Opcional |
Parámetro modificador |
Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente. |
Confirm |
Opcional |
Parámetro modificador |
Solicita confirmación antes de ejecutar el comando. |
Tipos de entrada
Ninguno.
Tipos de valores devueltos
Crea un objeto de tipo Microsoft.Rtc.Management.Xds.DisplayTrustedApplication.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
New-CsTrustedApplication -ApplicationId tapp1 -TrustedApplicationPoolFqdn TrustPool.litwareinc.com -Port 6000
En este ejemplo, se crea una aplicación de confianza con el Id. de aplicación tapp1. Usamos el parámetro TrustedApplicationPoolFqdn para designar el grupo de aplicaciones de confianza en el que se ubicará esta aplicación; en este caso es el grupo con el FQDN TrustPool.litwareinc.com. También debemos especificar un puerto para la aplicación; en este ejemplo se usa el puerto 6000. Tenga en cuenta que ejecutar este cmdlet especificando un ApplicationId y un TrustedApplicationPoolFqdn automáticamente generará un parámetro Identity que más tarde podrá usarse para recuperar, modificar o quitar esta aplicación.
-------------------------- Ejemplo 2 --------------------------
New-CsTrustedApplication -Identity TrustPool.litwareinc.com/tapp2 -Port 6100
Este ejemplo crea una aplicación de confianza con el parámetro Identity TrustPool.litwareinc.com/tapp2 en el puerto 6100. Preste atención al formato de Identity. Dicho valor debe estar en el formato <FQDN de grupo de confianza>/<Id. de aplicación>.
Vea también
Otros recursos
Remove-CsTrustedApplication
Set-CsTrustedApplication
Get-CsTrustedApplication