Get-CsTrustedApplicationComputer
Última modificación del tema: 2012-03-23
Recupera información acerca de uno o varios equipos que hospedan aplicaciones de confianza.
Sintaxis
Get-CsTrustedApplicationComputer [-Identity <XdsGlobalRelativeIdentity>] [-Pool <String>]
Get-CsTrustedApplicationComputer [-Filter <String>] [-Pool <String>]
Descripción detallada
Recomendamos que los equipos que ejecutan las aplicaciones de confianza en una instalación de Microsoft Lync Server 2010 se agreguen a un grupo de servidores independiente utilizado únicamente para aplicaciones de confianza. No obstante, se pueden agregar equipos de aplicaciones de confianza a un grupo de servidores existente que también se utiliza con otros fines. Utilice este cmdlet para recuperar la Identity (FQDN) y el grupo de servidores en el que se encuentra uno o varios equipos que contienen aplicaciones de confianza.
Puede usar este cmdlet para recuperar equipos basados en el FQDN del equipo o recuperar todos los equipos que forman parte de un grupo de servidores especificado.
Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Get-CsTrustedApplicationComputer localmente: RTCUniversalUserAdmins, 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 "Get-CsTrustedApplicationComputer"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
XdsGlobalRelativeIdentity |
El nombre de dominio completo (FQDN) del equipo que desea recuperar. |
Filter |
Opcional |
Cadena de caracteres |
Cadena que incluye caracteres comodín que permite recuperar equipos de confianza en función de valores de Identity que coinciden con la cadena de caracteres comodín indicada. |
Pool |
Opcional |
Cadena de caracteres |
El FQDN del grupo de servidores de aplicaciones de confianza del que desea recuperar información de equipos. |
Tipos de entrada
Ninguno.
Tipos de valores devueltos
Recupera uno o más objetos del tipo Microsoft.Rtc.Management.Xds.DisplayComputer.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Get-CsTrustedApplicationComputer
En el Ejemplo 1 se recuperan todos los equipos asignados a un grupo de servidores de aplicaciones de confianza en la implementación de Lync Server 2010.
-------------------------- Ejemplo 2 ------------------------
Get-CsTrustedApplicationComputer -Identity Trust1.litwareinc.com
En el Ejemplo 2 se recupera información acerca del equipo con el FQDN Trust1.litwareinc.com.
-------------------------- Ejemplo 3 ------------------------
Get-CsTrustedApplicationComputer -Filter Trust*
En este ejemplo se usa el parámetro Filter para realizar una búsqueda de caracteres comodín que tienen un FQDN que comienza con la cadena Trust y que se han asignado a grupos de servidores de aplicaciones de confianza. El parámetro Filter busca la propiedad Identity de todos los equipos con aplicaciones de confianza. El carácter comodín (*) al final de la cadena significa que Filter deberá buscar identidades que comiencen con la cadena Trust seguida de cualquier otro carácter.
-------------------------- Ejemplo 4 ------------------------
Get-CsTrustedApplicationComputer -Pool TrustPool.litwareinc.com
En el Ejemplo 4 se recupera una lista de todos los equipos asignados al grupo de servidores de aplicaciones de confianza TrustPool.litwareinc.com.
-------------------------- Ejemplo 5 ------------------------
Get-CsTrustedApplicationComputer | Where-Object {$_.Pool -like "*.litwareinc.com"}
En el Ejemplo 3 se usa el parámetro Filter para realizar una búsqueda de caracteres comodín basada en la Identity (el FQDN del equipo). En este ejemplo, realizamos de nuevo una búsqueda de caracteres comodín pero, en esta ocasión, en el grupo en lugar de en la identidad. En primer lugar se llama a Get-CsTrustedApplicationComputer para recuperar una colección de todos los equipos con aplicaciones de confianza. A continuación, esta colección se transfiere al cmdlet Where-Object. Where-Object permite restringir la colección transferida. En este caso, queremos que sólo se conserven los equipos con aplicaciones de confianza que estén en cualquier grupo de servidores del dominio litwareinc.com. Para ello, comprobamos la propiedad Pool de cada elemento de la colección ($_.Pool) y vemos si coincide (-like) con la cadena de caracteres comodín *.litwareinc.com. Un valor coincidirá con esa cadena si comienza por cualquier conjunto de caracteres y finaliza por la cadena .litwareinc.com.