Compartir a través de

  • Artículo

Publish-CsTopology

 

Última modificación del tema: 2012-03-25

Publica la topología de Microsoft Lync Server 2010 recuperada con el cmdlet Get-CsTopology.

Sintaxis

Publish-CsTopology -FileName <String> [-BackupFileName <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>] [-WhatIf [<SwitchParameter>]]

Publish-CsTopology -Document <XElement> [-BackupFileName <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>] [-WhatIf [<SwitchParameter>]]

Publish-CsTopology -FinalizeUninstall <SwitchParameter> [-BackupFileName <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Después de instalar Lync Server 2010, llegará el momento en que tenga que realizar cambios en la infraestructura de Lync Server. Por ejemplo, podría necesitar agregar un sitio nuevo, eliminar un grupo de registradores existente o agregar un Servidor de archivado adicional. Estos cambios de infraestructura deben realizarse a través de Topology Builder. Una vez realizados los cambios en Topology Builder, puede publicarlos y habilitarlos con la misma herramienta. Estos dos últimos pasos son muy importantes: aunque puede llevar a cabo tantas modificaciones como desee mediante Topology Builder, dichas modificaciones no surten efecto y la infraestructura de Lync Server no cambia hasta que se hayan publicado las modificaciones y se haya habilitado la nueva topología.

Cuando se publican los cambios, la nueva información (por ejemplo, un sitio o un rol de servidor nuevos) se escribe en el Almacén de administración central. Sin embargo, estos objetos nuevos (o recién modificados) no se unen inmediatamente a la topología. No se incorporarán hasta que se haya habilitado la topología actualizada. Si selecciona la opción Publish de Topology Builder, tendrán lugar estas dos acciones: se publicarán los cambios (se escribirán en el Almacén de administración central) y, a continuación, se habilitará la nueva topología.

El cmdlet Publish-CsTopology ha dejado de ser el método recomendado para publicar topologías creadas mediante Topology Builder. En su lugar, se deberán publicar en Topology Builder con los pasos descritos en el párrafo anterior. Esto se debe a que Topology Builder utiliza ahora el formato de archivo XML de Topology Builder (.tbxml) y este formato de archivo no se puede publicar con Publish-CsTopology. Lo único que se puede hacer con Publish-CsTopology es volver a publicar una topología recuperada utilizando el cmdlet Get-CsTopology. Después de publicar la topología de este modo, tendrá que reconfigurar las direcciones URL sencillas.

Quién puede ejecutar este cmdlet: de manera predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar localmente el cmdlet Publish-CsTopology: RTCUniversalServerAdmins. Sin embargo, si no se han delegado los permisos de configuración, será un administrador del dominio quien pueda ejecutar Publish-CsTopology. Para ceder a RTCUniversalServerAdmins el derecho de utilizar el cmdlet Publish-CsTopology, debe ejecutar el cmdlet Grant-CsSetupPermission en todos los contenedores de Active Directory que contengan equipos que ejecuten servicios de Lync Server. Observe que esta restricción también se aplica a la habilitación de topologías mediante Topology Builder. Si no ha delegado los permisos utilizando Set-CsSetupPermission, solamente un administrador de dominio podrá publicar una topología mediante Topology Builder.

Parámetros

Parámetro Requerido Tipo Descripción

FileName

Requerido

Cadena de caracteres

Ruta de acceso completa al archivo XML que contiene la información de la nueva topología.

BackupFileName

Opcional

Cadena de caracteres

Ruta de acceso completa al archivo de copia de seguridad creado automáticamente al ejecutar Publish-CsTopology. Si no se especifica este parámetro, Publish-CsTopology creará un archivo de copia de seguridad en la carpeta Temp (%temp%) similar a este: Publish-CsTopology-Backup-[2010_10_01][08_30_00]. En este nombre de archivo, 2010_10_01 representa la fecha en la que se produjo la publicación: año (2010), mes (10) y día (01). Además, 08_30_00 representa la hora del día a la que tuvo lugar la publicación: hora (08), minutos (30) y segundos (00).

Document

Opcional

System.XML.Linq.XElement object

Permite publicar un elemento XML en lugar de un archivo XML. Este elemento XML debe configurarse como objeto System.XML.Linq.XElement.

FinalizeUninstall

Opcional

Parámetro modificador

Solo se utiliza para desinstalar Lync Server 2010. Cuando se haya eliminado el Servidor de administración central, utilice Publish-CsTopology y el parámetro FinalizeUninstall para publicar una topología vacía. Entre otras cosas, esto elimina todas las entradas de Active Directory del Servidor de administración central.

GlobalCatalog

Opcional

Cadena de caracteres

Nombre de dominio completo (FQDN) de un servidor de catálogo global del dominio. Este parámetro no se necesita si ejecuta Publish-CsTopology en un equipo con una cuenta en el dominio.

GlobalSettingsDomainController

Opcional

Cadena de caracteres

FQDN de un controlador de dominio donde está almacenada la configuración global. Si la configuración global se almacena en el contenedor del sistema de Active Directory Domain Services (AD DS), este parámetro debe señalar al controlador de dominio raíz. Si la configuración global está almacenada en el contenedor de configuración, se puede usar cualquier controlador de dominio y omitir este parámetro.

SkipPrepareCheck

Opcional

Booleano

Si se configura como True ($True), Publish-CsTopology omitirá su comprobación de preparación inicial.

Force

Opcional

Parámetro modificador

Suprime la visualización de los mensajes de error que no sean graves y que puedan ocurrir al ejecutar el comando.

Report

Opcional

Cadena de caracteres

Permite especificar una ruta de archivo para el archivo de registro creado al ejecutar el cmdlet. Por ejemplo: -Report "C:\Logs\Publish_Topology.html"

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. Publish-CsTopology no acepta una entrada transferida.

Tipos de valores devueltos

Ninguno. En su lugar, Publish-CsTopology publica instancias del objeto Microsoft.Rtc.Management.Deploy.Internal.DefaultTopology.

Ejemplo

-------------------------- Ejemplo 1 --------------------------

(Get-CsTopology -AsXml).ToString() > C:\Topologies\Topology.xml 
Publish-CsTopology -FileName "C:\Topologies\Topology.xml"

Los comandos del Ejemplo 1 recuperan y, a continuación vuelven a publicar, la topología actual. Para llevar a cabo estas tareas, el primer comando del ejemplo usa Get-CsTopology y el parámetro AsXml para recuperar la topología actual. El símbolo de redirección de Windows PowerShell > se usa entonces para guardar los datos recuperados en un archivo llamado C:\Topologies\Topology.xml. (Observe también que el método ToString se emplea para convertir la topología recuperada en un valor de cadena). El segundo comando del ejemplo usa Publish-CsTopology para volver a publicar la topología recién recuperada.