Set-CsSite
Última modificación del tema: 2012-03-26
Modifica las propiedades de cualquiera de los sitios 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 (sucursal).
Sintaxis
Set-CsSite [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-DisplayName <String>] [-FederationRoute <String>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
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 dichos equipos. Si los equipos de Dublín se encuentran en su propia red de área local y comparten conexiones de alta velocidad y baja latencia, también puede crear un sitio de Dublín por separado. Los sitios también tienen una función clave en la administración de Lync Server: muchas directivas y 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.
Los sitios se crean con Topology Builder y cualquier cambio en la infraestructura de los sitios (por ejemplo, agregar nuevos grupos de servidores) también debe hacerse con Topology Builder. No obstante, puede usar el cmdlet Set-CsSite para cambiar el nombre para mostrar, la descripción y la ruta de federación de cualquier sitio de la organización.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Set-CsSite de manera local: RTCUniversalServerAdmins. 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 "Set-CsSite"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Identidad Xds |
Nombre del sitio que se debe modificar, por ejemplo: -Identity "Redmond". No use el formato "site:Redmond" para especificar la identidad. |
Description |
Opcional |
Cadena de caracteres |
Permite a los administradores agregar información adicional para un objeto de sitio. Por ejemplo, la descripción puede incluir la información de contacto del sitio. |
DisplayName |
Opcional |
Cadena de caracteres |
Nombre descriptivo del sitio. Por ejemplo: -DisplayName "Norteamérica y Sudamérica". |
FederationRoute |
Opcional |
Cadena de caracteres |
Ubicación de servicio del Servidor perimetral usado para proporcionar un puente entre la red interna e Internet. Por ejemplo: -FederationRoute "EdgeServer:atl-edge-001.litwareinc.com". |
Force |
Opcional |
Parámetro modificador |
Suprime cualquier aviso de confirmación o mensaje de error leve que se pueda producir al ejecutar el cmdlet. |
WhatIf |
Opcional |
Parámetro modificador |
Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente. |
Confirm |
Opcional |
Parámetro modificador |
Solicita confirmación antes de ejecutar el comando. |
Tipos de entrada
Ninguno. Set-CsSite no acepta entradas transferidas.
Tipos de valores devueltos
Set-CsSite no devuelve ningún valor ni objeto. En su lugar, el cmdlet modifica instancias del objeto Microsoft.Rtc.Management.Deploy.Internal.Site+CentralSite.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Set-CsSite -Identity Redmond -Description "Full-time employees in Redmond, WA."
El comando que se muestra en el Ejemplo 1 modifica la propiedad Description del sitio de Redmond (-Identity Redmond).
-------------------------- Ejemplo 2 ------------------------
Set-CsSite -Identity Redmond -DisplayName "US Headquarters"
El comando anterior cambia el nombre para mostrar para el sitio de Redmond por "US Headquarters".
-------------------------- Ejemplo 3 ------------------------
Get-CsSite | Where-Object {$_.Description -eq $Null} | ForEach-Object {Set-CsSite $_.Identity -Description "Litwareinc.com"}
El comando mostrado en el ejemplo 3 localiza todos los sitios que no tengan una descripción y, a continuación, les asigna la descripción genérica "Litwareinc.com." Para ello, el comando primero llama a Get-CsSite sin parámetros para devolver una recopilación de todos los sitios de Lync Server. La recopilación devuelta se transfiere al cmdlet Where-Object, que únicamente selecciona los sitios cuya propiedad Description sea igual a (-eq) un valor nulo ($Null). A continuación, los sitios se transfieren al cmdlet ForEach-Object. Este cmdlet selecciona todos los elementos de la recopilación y usa Set-CsSite para modificar el valor de la propiedad Description.