Get-CsApplicationEndpoint
Última modificación del tema: 2012-03-23
Recupera los extremos de Servicio de aplicaciones.
Sintaxis
Get-CsApplicationEndpoint [-Identity <UserIdParameter>] [-ApplicationId <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-PoolFqdn <String>] [-ResultSize <Unlimited>]
Descripción detallada
Este cmdlet recupera uno o más contactos de aplicación de Active Directory Domain Services (AD DS). Estos objetos se almacenan en Active Directory, dentro del contenedor de contactos de aplicación del servicio RTC.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Get-CsApplicationEndpoint de forma local: RTCUniversalUserAdmins, RTCUniversalServerAdmins, 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 (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsApplicationEndpoint"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
UserIdParameter |
La identidad, la dirección SIP o el nombre para mostrar del extremo de la aplicación que se va a recuperar. La Identidad consta del nombre distintivo del extremo. Suele contener un identificador único global (GUID) como parte del CN, como: CN={8811fefe-e0bb-4fab-ae39-7aaeddd423dc},CN=Application Contacts,CN=RTC Service,CN=Services,CN=Configuration,DC=Vdomain,DC=com. |
ApplicationId |
Opcional |
Cadena de caracteres |
El id. de aplicación del extremo de aplicación que desea recuperar. El id. de aplicación es el valor de la propiedad OwnerUrn del extremo. Por ejemplo, si la propiedad OwnerUrn tiene el valor urn:application:Caa, el id. de aplicación será urn:application:Caa. También puede introducir solamente el sufijo (en este caso, Caa) para recuperar el extremo. Por ejemplo: -ApplicationId Caa |
Credential |
Opcional |
PSCredential |
Credenciales alternativas que utilizará la operación Get. Puede recuperar un objeto PSCredential llamando al cmdlet Get-Credential de Windows PowerShell. |
DomainController |
Opcional |
Fqdn |
Permite especificar un controlador de dominio. Si no se especifica ningún controlador de dominio, se usará el primero que esté disponible. |
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 limitar los datos devueltos e incluir solo los contactos cuyos nombres para mostrar o direcciones SIP coincidan con cierto patrón de caracteres comodín. 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 solo contactos habilitados para Enterprise Voice tendría este aspecto: {EnterpriseVoiceEnabled -eq $True}, donde 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. |
OU |
Opcional |
OUIdParameter |
La unidad organizativa (UO) donde reside el extremo. |
PoolFqdn |
Opcional |
Cadena de caracteres |
El nombre de dominio completo (FQDN) del grupo donde reside el extremo de la aplicación. |
ResultSize |
Opcional |
Sin límite |
El número máximo de registros de extremo que se recuperarán. |
Tipos de entrada
Cadena de caracteres. Acepta un valor de cadena transmitido que representa la identidad del extremo de la aplicación.
Tipos de valores devueltos
Recupera un objeto de tipo Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Get-CsApplicationEndpoint
Este ejemplo recupera información sobre todos los extremos de aplicación definidos dentro de la implementación de Lync Server 2010.
-------------------------- Ejemplo 2 ------------------------
Get-CsApplicationEndpoint -Identity "Call Park Service Contact"
En el Ejemplo 2 se recupera información sobre el contacto de extremo de aplicación con el nombre para mostrar “Call Park Service Contact”.
-------------------------- Ejemplo 3 ------------------------
Get-CsApplicationEndpoint -Filter {DisplayName -like "*endpoint*"}
En el Ejemplo 3 se recuperan todos los extremos de aplicación cuyo nombre para mostrar contenga la cadena “endpoint”. Para ello, el comando usa el parámetro Filter. El valor del parámetro filtra los objetos de extremo cuyo nombre para mostrar (DisplayName) contiene (-like) la cadena endpoint (*endpoint*: los caracteres comodín indican que puede haber cualquier carácter antes y después de la cadena endpoint, es decir, que endpoint puede estar en cualquier parte del nombre para mostrar).
-------------------------- Ejemplo 4 ------------------------
Get-CsApplicationEndpoint -ApplicationId tapp2 | Select-Object Identity, SipAddress, DisplayName, OwnerUrn
El Ejemplo 4 devolverá todos los extremos de aplicación asociados a la aplicación urn:application:tapp2. Para ello, se pasa el id. tapp2 al parámetro ApplicationId. Tenga en cuenta que no hemos facilitado ningún nombre de dominio completo para el grupo; esto implica que, si existen aplicaciones con el id. tapp2 en más de un grupo, se recuperarán los extremos de todas esas aplicaciones. La siguiente parte de este comando transfiere los objetos devueltos al cmdlet Select-Object, que muestra solo las propiedades Identity, SipAddress, DisplayName y OwnerUrn de esos objetos.