Compartir a través de

  • Artículo

Get-CsTrustedApplicationEndpoint

 

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

Recupera información sobre uno o más extremos de aplicación de confianza.

Sintaxis

Get-CsTrustedApplicationEndpoint [-Identity <UserIdParameter>] [-ApplicationId <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>] [-TrustedApplicationPoolFqdn <String>]

Descripción detallada

Un extremo de aplicación de confianza es un objeto de contacto de Active Directory que habilita el enrutamiento de llamadas en una aplicación de confianza. Este cmdlet recupera información sobre uno o más objetos de contacto de extremo de Active Directory Domain Services (AD DS).

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Get-CsTrustedApplicationEndpoint de manera local: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC), se ha asignado este cmdlet (incluidos los roles RBAC que haya creado usted mismo) para ejecutar el siguiente comando desde el símbolo del sistema de Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

UserIdParameter

La identidad (nombre distintivo), la dirección SIP o el nombre para mostrar del extremo de la aplicación que se va a modificar.

Filter

Opcional

Cadena de caracteres

Permite limitar los datos que se devuelven filtrando los atributos específicos de Microsoft Lync Server 2010. Por ejemplo, puede restringir los datos devueltos a los contactos cuyo nombre para mostrar o cuya dirección SIP coincida con un determinado patrón de comodines.

El parámetro Filter usa la misma sintaxis de filtrado de Windows PowerShell que usa el cmdlet Where-Object. Por ejemplo, un filtro que devuelva sólo contactos habilitados para Enterprise Voice tendría este aspecto: {EnterpriseVoiceEnabled -eq $True}, EnterpriseVoiceEnabled representa el atributo de Active Directory, -eq representa el operador de comparación (igual a), y $True (una variable de Windows PowerShell integrada) representa el valor del filtro.

ApplicationId

Opcional

Cadena de caracteres

El identificador de aplicación de la aplicación de confianza para el extremo que desea recuperar.

Credential

Opcional

PSCredential

Credenciales alternativas que se deben usar para recuperar el extremo. Puede recuperar un objeto PSCredential llamando al cmdlet Get-Credential.

DomainController

Opcional

Fqdn

Permite especificar un controlador de dominio. Si no se especifica ninguno, se usará el primero que haya disponible.

OU

Opcional

OUIdParameter

La unidad organizativa donde reside el extremo.

ResultSize

Opcional

Sin límite

El número máximo de registros de extremo que recuperar.

TrustedApplicationPoolFqdn

Opcional

Cadena de caracteres

El nombre de dominio completo (FQDN) del grupo de servidores de la aplicación de confianza asociado con la aplicación para el extremo que desea recuperar.

Tipos de entrada

Cadena de caracteres. Acepta un valor de cadena transferido que representa la identidad de una cuenta de usuario.

Tipos de valores devueltos

Recupera un objeto de tipo Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact.

Ejemplo

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

Get-CsTrustedApplicationEndpoint

En este ejemplo se recupera información sobre todos los extremos de aplicación de confianza definidos en la implementación de Lync Server 2010.

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

Get-CsTrustedApplicationEndpoint -Identity "sip:endpoint1@litwareinc.com"

En el Ejemplo 2 se recupera información sobre el contacto de extremo de aplicación con la dirección SIP endpoint1@litwareinc.com. Tenga en cuenta que el prefijo sip: es necesario si se usa una dirección SIP como identidad.

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

Get-CsTrustedApplicationEndpoint -Filter {DisplayName -like "*endpoint*"}

En el Ejemplo 3, se recuperan todos los extremos de aplicación de confianza cuyo nombre para mostrar contenga la cadena de caracteres “endpoint”. Para ello, el comando usa el parámetro Filter. El valor del parámetro aplica un filtro para encontrar los objetos de extremo con un nombre para mostrar (DisplayName) que contenga (-like) el extremo de cadena de caracteres (*endpoint*, los caracteres comodín indican que puede haber un número cualquiera de caracteres antes o después del extremo de cadena de caracteres, lo que significa que el extremo puede estar en cualquier parte del nombre para mostrar).

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

Get-CsTrustedApplicationEndpoint -ApplicationId tapp2 | Select-Object SipAddress, DisplayName, OwnerUrn

En el Ejemplo 4 se devuelven todos los extremos de aplicación de confianza asociados con la aplicación tapp2. Para ello, se transfiere el identificador tapp2 al parámetro ApplicationId. Tenga en cuenta que no se ha proporcionado ningún FQDN de grupo de servidores, lo que significa que si existe una aplicación con el identificador tapp2 en más de un grupo de servidores, se recuperarán los extremos de todas estas aplicaciones. En la parte siguiente de este comando se transfiere el objeto o los objetos devueltos al cmdlet Select-Object, que solo muestra las propiedades SipAddress, DisplayName y OwnerUrn de estos objetos.