Get-CsSite
Última modificación del tema: 2012-03-23
Recupera información acerca de los sitios creados como parte de la infraestructura de Microsoft Lync Server 2010. Los sitios representan una recopilación de grupos de servidores de Lync Server 2010 y suelen designarse por zonas geográficas. Lync Server incluye dos tipos de sitios: los sitios de centros de datos y los sitios remotos (sucursales).
Sintaxis
Get-CsSite [-Identity <XdsGlobalRelativeIdentity>]
Get-CsSite [-Filter <String>]
Descripción detallada
Lync Server 2010 incorpora un nuevo concepto a la topología de Lync Server: los sitios. Los sitios (que no deben confundirse con los sitios de Active Directory ni con los sitios de Microsoft Exchange Server) son una recopilación de servidores y grupos de servidores de Lync Server que suelen organizarse según la zona geográfica y el ancho de banda de la red. Por ejemplo, si todos sus equipos de Redmond se encuentran en la misma red de área local con conexiones de alta velocidad y baja latencia, puede designar un sitio de Redmond que englobe todos los equipos. Si los equipos de Dublín están ubicados en su propia red de área local y comparten conexiones de alta velocidad y baja latencia, también podría crear un sitio Dublín separado. Los sitios cumplen un rol esencial en la administración de Lync Server: la mayoría de las directivas y de los valores se pueden configurar en el ámbito del sitio, de modo que resulta fácil aplicar un conjunto de planes de marcado a los usuarios de Redmond y un conjunto de planes de marcado distinto a los usuarios que estén en Dublín.
El cmdlet Get-CsSite lo habilita para recuperar información acerca de todos los sitios de la organización, por ejemplo, acerca de los grupos que conforman cada uno de esos sitios.
Quiénes pueden ejecutar este cmdlet: De manera predeterminada, los miembros de los siguientes grupos están autorizados para ejecutar el cmdlet Get-CsSite en forma local: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsSite"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
SiteId |
Nombre del sitio a devolver. Tenga en cuenta que solo debe especificar el nombre del sitio; por ejemplo: -Identity "Redmond". No use el formato "site:Redmond" para especificar la identidad. |
Filter |
Opcional |
Cadena de caracteres |
Le permite usar comodines al especificar el parámetro Identity del sitio (o los sitios) a devolver. Por ejemplo, esta sintaxis devuelve todos los grupos cuyo parámetro Identity incluye el valor de cadena "Dublin": -Filter "*Dublin*". Tenga en cuenta que no es posible usar los parámetros Filter y Identity en el mismo comando. |
Tipos de entrada
Ninguno. Get-CsSite no acepta entradas canalizadas.
Tipos de valores devueltos
Get-CsSite devuelve instancias del objeto Microsoft.Rtc.Management.Deploy.Internal.Site+CentralSite.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Get-CsSite
En el Ejemplo 1 se recupera información acerca de todos los sitios de Lync Server.
-------------------------- Ejemplo 2 --------------------------
Get-CsSite -Identity "Redmond"
En el Ejemplo 2, se devuelve información acerca de un solo sitio: aquel cuyo parámetro Identity es Redmond.
-------------------------- Ejemplo 3 --------------------------
Get-CsSite | Where-Object {$_.SiteType -eq "CentralSite"}
El comando que se muestra en el Ejemplo 3 devuelve información acerca del sitio central. Para llevar a cabo esta tarea, el comando primero llama a Get-CsSite a fin de devolver una recopilación de todos los sitios configurados para el uso de la organización. A continuación, esta recopilación se canaliza al cmdlet Where-Object, que selecciona el único sitio cuya propiedad SiteType es igual a "CentralSite".
-------------------------- Ejemplo 4 --------------------------
Get-CsSite -Identity "Redmond" | Select-Object -ExpandProperty Pools
El comando anterior muestra la lista de grupos que se encuentran en el sitio Redmond. Para ello, el comando primero recupera la información completa del sitio Redmond y luego canaliza los datos al cmdlet Select-Object. Por su parte, Select-Object usa el parámetro ExpandProperty para "expandir" el valor de la propiedad Pools. Expandir el valor de una propiedad significa que todos los valores almacenados en la propiedad se mostrarán en la pantalla, en un formato de fácil lectura.