Get-CsPool
Última modificación del tema: 2012-03-23
Devuelve información sobre los grupos usados en la implementación de Microsoft Lync Server 2010. Los grupos son una colección de equipos de un sitio que ejecutan el mismo conjunto de servicios de Lync Server 2010.
Sintaxis
Get-CsPool [-Identity <XdsGlobalRelativeIdentity>] [-Site <String>]
Get-CsPool [-Filter <String>] [-Site <String>]
Descripción detallada
En Lync Server 2010, un grupo está formado por uno o más equipos localizados en el mismo sitio y que ejecutan el mismo conjunto de servicios. Por ejemplo, si tiene un servidor que ejecuta el servicio de servidor de mediación en el sitio de Redmond, tiene un grupo de servidor de mediación compuesto por un solo equipo. Si tiene dos equipos que ejecutan el servidor de mediación en el sitio de Redmond, tiene un grupo de servidor de mediación compuesto por dos equipos. El número de grupos que se usan en la organización depende del número de servidores que tenga y de los diferentes servicios que ejecuten dichos servidores.
El cmdlet Get-CsPool le permite recuperar información sobre cada grupo que esté en uso en la organización, incluida la información sobre los servicios que se ejecutan en cada uno de los grupos.
Quién puede ejecutar este cmdlet: de manera predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar localmente el cmdlet Get-CsPool: 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-CsPool"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Cadena de caracteres |
Nombre de dominio completo (FQDN) del grupo de servidores que se devolverá. Por ejemplo: -Identity atl-cs-001.litwareinc.com. Si este parámetro no está presente, se devolverán todos los grupos de la organización. |
Filter |
Opcional |
Cadena de caracteres |
Permite usar caracteres comodín para especificar la identidad del grupo o los grupos que se van a devolver. Por ejemplo, esta sintaxis devuelve todos los grupos que tengan una identidad que termine con el valor de cadena de caracteres ".fabrikam.com": -Filter "*.fabrikam.com". Tenga en cuenta que no se pueden utilizar ambos parámetros, Filter e Identity, en el mismo comando. |
Site |
Opcional |
Cadena de caracteres |
Devuelve todos los grupos del sitio especificado. Debe hacerse referencia al sitio en cuestión usando el nombre para mostrar (DisplayName) del sitio (por ejemplo, Redmond) en lugar de la identidad (Identity) (por ejemplo, site:Redmond). Por ejemplo: -Site "Redmond". Puede recuperar los nombres para mostrar de sus sitios mediante la ejecución de este comando: Get-CsSite | Select-Object Identity, DisplayName |
Tipos de entrada
Ninguno. Get-CsPool no acepta una entrada transferida.
Tipos de valores devueltos
Get-CsPool devuelve instancias del objeto Microsoft.Rtc.Management.Deploy.Internal.Cluster.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Get-CsPool
El comando anterior devuelve todos los grupos encontrados en la implementación de Lync Server.
-------------------------- Ejemplo 2 --------------------------
Get-CsPool | Select-Object -ExpandProperty Computers
El Ejemplo 2 muestra información detallada sobre los equipos de cada grupo. Para ello, se llama a Get-CsPool y luego se transfieren los datos devueltos al cmdlet Select-Object. El parámetro ExpandProperty de Select-Object se utiliza entonces para expandir el valor de la propiedad Computers. La propiedad Computers es una matriz de objetos que representan a cada equipo del grupo. Cuando se expande la propiedad Computers, se obtiene información detallada sobre cada uno de estos equipos.
-------------------------- Ejemplo 3 --------------------------
Get-CsPool -Identity atl-cs-001.litwareinc.com
En el ejemplo anterior, se utiliza el parámetro Identity para limitar los datos devueltos al grupo que tenga Identity atl-cs-001.litwareinc.com.
-------------------------- Ejemplo 4 --------------------------
Get-CsPool -Site "Redmond"
El Ejemplo 4 devuelve todos los grupos del sitio de Redmond. Para ello, el comando usa el parámetro Site; el valor de parámetro "Redmond" limita los datos devueltos a los grupos cuya propiedad Site sea igual a Redmond.
-------------------------- Ejemplo 5 --------------------------
Get-CsPool | Where-Object {$_.Services.Count -eq 0}
El comando mostrado en el Ejemplo 5 devuelve una colección de todos los grupos que no tengan instalados los servicios de Lync Server. Para llevar a cabo esta tarea, el comando primero llama a Get-CsPool sin ningún parámetro, lo que devuelve una colección de todos los grupos que están en uso en la organización. Esta colección se transfiere al cmdlet Where-Object, que selecciona todos los grupos donde la propiedad Services.Count sea igual a 0. Si Count es igual a 0, significa que no hay servicios de Lync Server configurados para dicho grupo.