Set-CsDirector
Última modificación del tema: 2012-03-27
Modifica las propiedades de uno o más Directores. Los Directores se pueden usar para autenticar solicitudes de usuario, pero no hospedan cuentas de usuario.
Sintaxis
Set-CsDirector [-Identity <XdsGlobalRelativeIdentity>] [-ArchivingServer <String>] [-Confirm [<SwitchParameter>]] [-EdgeServer <String>] [-Force <SwitchParameter>] [-MonitoringServer <String>] [-SipHealthPort <UInt16>] [-SipPort <UInt16>] [-SipServerTcpPort <UInt16>] [-WebPort <UInt16>] [-WebServer <String>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
El Director autentica a los usuarios y responde a las solicitudes del usuario sin hospedar cuentas de usuarios en realidad. Los Directores habitualmente se usan en organizaciones que permiten el acceso externo a la red mediante servidores perimetrales. En ese escenario, los Directores no solo ayudan a aliviar la tensión de los servidores front-end (mediante el manejo de pedidos de autenticación) sino que además ayudan a proteger a la red interna de ataques por denegación de servicio y otro tráfico malintencionado. Los Directores también son útiles cada vez que implementan varios servidores front-end en un sitio central. En ese caso, los Directores reciben todos los pedidos de los usuarios y después enviarán por canal los pedidos al grupo de servidores apropiado. Nuevamente, esto ayuda a reducir la carga impuesta a los servidores front-end.
El cmdlet Set-CsDirector le permite modificar los valores de las propiedades de cualquiera de los Directores que están actualmente en uso en su organización. Incluye cambiar cosas como el Servidor de archivado o el Servidor perimetral asociado con el Director o cambiar el puerto usado para enviar y recibir tráfico SIP.
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Set-CsDirector localmente: RTCUniversalServerAdmins. 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 "Set-CsDirector"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Identidad Xds |
Ubicación de servicio del Director que se modificará. Por ejemplo: -Identity "Director:atl-cs-001.litwareinc.com". Tenga en cuenta que puede dejar el prefijo "Director:" al especificar un Director. Por ejemplo: -Identity "atl-cs-001.litwareinc.com". |
ArchivingServer |
Opcional |
Cadena de caracteres |
Ubicación del servicio del Servidor de archivado que se asociará al Director. Por ejemplo: -ArchivingServer "ArchivingServer:atl-cs-001.litwareinc.com". |
EdgeServer |
Opcional |
Cadena de caracteres |
Ubicación del servicio del Servidor perimetral que se asociará al Director. Por ejemplo: -EdgeServer "EdgeServer:atl-edge-001.litwareinc.com" |
MonitoringServer |
Opcional |
Cadena de caracteres |
Ubicación del servicio del Servidor de supervisión que se asociará al Director. Por ejemplo: -MonitoringServer "MonitoringServer:atl-cs-001.litwareinc.com". |
SipPort |
Opcional |
Integer |
Puerto usado para el tráfico de Protocolo de inicio de sesión (SIP). |
SipHealthPort |
Opcional |
Entero |
Puerto que se utiliza para supervisar el estado del servidor. |
SipServerTcpPort |
Opcional |
Entero |
Puerto de escucha SIP. El valor predeterminado es 5060. |
WebPort |
Opcional |
Entero |
Puerto usado para comunicarse con Servicios web. |
WebServer |
Opcional |
Cadena de caracteres |
Ubicación del servidor del Servicios web que se asociará al Director. Por ejemplo: -WebServer "WebServer:atl-cs-001.litwareinc.com" |
Force |
Opcional |
Parámetro modificador |
Suprime la visualización de los mensajes de error que no sean graves y que puedan producirse al ejecutar el comando. |
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-CsDirector no acepta entradas canalizadas.
Tipos de valores devueltos
Set-CsDirector no devuelve objetos o valores. En su lugar, el cmdlet modifica instancias existentes del objeto Microsoft.Rtc.Management.Xds.DisplayDirector.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Set-CsDirector -Identity "Director:atl-cs-001.litwareinc.com" -ArchivingServer "ArchivingServer:dublin-cs-001.litwareinc.com"
El comando que se muestra en el Ejemplo 1 cambia el Servidor de archivado asociado con Director:atl-cs-001.litwareinc.com. del Director. En este ejemplo, el Servidor de archivado se cambia a ArchivingServer:dublin-cs-001.litwareinc.com.
-------------------------- Ejemplo 2 --------------------------
Get-CsService -Director | ForEach-Object {Set-CsDirector -Identity $_.Identity -SipPort 5072}
El comando anterior cambia el puerto SIP de todos los Directores actualmente en uso en la organización. Para ello, el comando primero usa Get-CsService y el parámetro Director para devolver una recopilación de todos los Directores de la organización. A continuación, esa recopilación se transfiere a ForEach-Object. A su vez, ForEach-Object ejecuta Set-CsDirector en cada sitio de la recopilación, y cambia el valor de la propiedad SipPort property a 5072.