Compartir a través de

  • Artículo

New-CsTrustedApplicationEndpoint

 

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

Crea un nuevo contacto de extremo para una aplicación de confianza.

Sintaxis

New-CsTrustedApplicationEndpoint -ApplicationId <String> -TrustedApplicationPoolFqdn <Fqdn> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-LineURI <String>] [-PassThru <SwitchParameter>] [-PrimaryLanguage <String>] [-SecondaryLanguages <MultiValuedProperty>] [-SipAddress <String>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Un extremo de aplicación de confianza es un objeto de contacto de Active Directory que habilita el enrutamiento de llamadas a una aplicación de confianza. Este cmdlet crea un nuevo objeto de contacto de extremo en Active Directory Domain Services (AD DS) para una determinada aplicación.

Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet New-CsTrustedApplicationEndpoint localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en rol (RBAC), este rol se ha asignado (así como cualquier otro rol RBAC personalizado que haya creado) para ejecutar el siguiente comando desde el símbolo del sistema Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

ApplicationId

Requerido

Cadena de caracteres

El id. de aplicación de la aplicación de confianza para la que se está creando el contacto de extremo. Ya debe existir una aplicación con este id. Tenga en cuenta que puede incluir solamente la parte del nombre del identificador de aplicación; no es necesario (aunque se pueda) incluir la información de prefijo. Por ejemplo, si el id. de aplicación es urn:application:TrustedApp1, solo necesitará pasar la cadena TrustedApp1 a este parámetro.

TrustedApplicationPoolFqdn

Requerido

Fqdn

El nombre de dominio completo (FQDN) del grupo de la aplicación de confianza asociado a la aplicación. Para poder crear el extremo, la aplicación ya debe estar asociada al grupo.

SipAddress

Opcional

Cadena de caracteres

Una dirección SIP para el nuevo objeto de contacto. Si no incluye ningún valor para este parámetro, se generará una dirección SIP automáticamente con el formato sip:RtcApplication-<GUID>.<dominio>, por ejemplo, sip:RtcApplication-fbf9e2d1-c6aa-45a3-a045-b92d4ef961b2@litwareinc.com. El dominio será el dominio SIP predeterminado.

DisplayName

Opcional

Cadena de caracteres

El nombre para mostrar del objeto de contacto de extremo.

DisplayNumber

Opcional

Cadena de caracteres

El número de teléfono del contacto, tal y como aparecerá en la libreta de direcciones.

LineURI

Opcional

Cadena de caracteres

El número de teléfono del contacto. Debe tener el formato TEL:<número>, por ejemplo, TEL:+34915551212.

PrimaryLanguage

Opcional

Int32

Idioma principal usado para la aplicación de confianza. El idioma se puede configurar con un código de idioma válido, como en-US (inglés, Estados Unidos), fr-FR (francés), etc.

SecondaryLanguages

Opcional

Int32[]

Colección de idiomas que también se puede usar para las aplicaciones de confianza. Los valores se deben configurar como una lista de valores separados por coma de códigos de idioma. Por ejemplo, en la siguiente sintaxis, francés de Canadá y francés se establecen como idiomas secundarios: -SecondaryLanguages "fr-CA","fr-FR".

Tenant

Opcional

Identificador único global

El identificador único global (GUID) del objeto. Este parámetro no se usa para las implementaciones locales.

PassThru

Opcional

Parámetro modificador

Devuelve los resultados de este comando. Al ejecutar este cmdlet se mostrará el objeto recién creado; si se incluye este parámetro se repetirían los datos generados, por lo que el uso del parámetro es redundante.

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.ADConnect.Schema.OCSADApplicationContact.

Ejemplo

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

New-CsTrustedApplicationEndpoint -ApplicationId tapp1 -TrustedApplicationPoolFqdn TrustPool.litwareinc.com

En este ejemplo se crea un extremo de aplicación de confianza para la aplicación con id. de aplicación tapp1 alojada en el grupo TrustPool.litwareinc.com. ApplicationID y TrustedApplicationPoolFqdn son los únicos parámetros obligatorios para crear un extremo de aplicación de confianza. Sin embargo, tenga en cuenta que, si solo se asignan valores a estos dos parámetros, se autogenerará una dirección SIP para el contacto. Para garantizar que la dirección SIP sea única, la dirección generada automáticamente incluirá un identificador único global (GUID) y será similar a esta: sip:RtcApplication-fbf9e2d1-c6aa-45a3-a045-b92d4ef961b2@litwareinc.com. Si desea una dirección SIP más sencilla, vea el Ejemplo 2.

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

New-CsTrustedApplicationEndpoint -ApplicationId tapp1 -TrustedApplicationPoolFqdn TrustPool.litwareinc.com -SipAddress sip:endpoint1@litwareinc.com

En el Ejemplo 2, al igual que en el 1, se crea un extremo de aplicación de confianza para la aplicación con id. de aplicación tapp1 en el grupo TrustPool.litwareinc.com. A diferencia del Ejemplo 1, incluimos un parámetro más al crear el extremo: SipAddress. En lugar de dejar que el sistema genere una dirección SIP, hemos especificado la dirección endpoint1@litwareinc.com.