Compartilhar via

  • Artigo

Publish-CsTopology

 

Tópico modificado em: 2012-03-25

Publica a topologia do Microsoft Lync Server 2010 recuperada usando-se o cmdlet Get-CsTopology.

Sintaxe

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>]]

Descrição Detalhada

Depois que o Lync Server 2010 tiver sido instalado, talvez seja necessário fazer alterações à infraestrutura do Lync Server. Por exemplo, talvez seja necessário adicionar um novo site, excluir um pool de registradores existente ou adicionar um outro Servidor de Arquivamento. Essas alterações à infraestrutura devem ser feitas usando-se a Construtor de Topologias. Depois que se tiver feito as alterações no Construtor de Topologias, será possível publicar e habilitar essas alterações usando-se a mesma ferramenta. Essas duas últimas etapas são muito importantes: embora se possa fazer quantas modificações desejar usando o Construtor de Topologias, na verdade, essas modificações não entram em vigor nem a infraestrutura do Lync Server será efetivamente alterada enquanto as modificações não tiverem sido publicadas e a nova topologia tiver sido habilitada.

Quando as alterações forem publicadas, as novas informações (por exemplo: um novo site ou uma nova função de servidor) serão gravadas no Repositório de Gerenciamento Central. No entanto, esses objetos novos (ou recentemente modificados) não participam imediatamente da topologia. Isso ocorrerá apenas quando a topologia atualizada tiver sido habilitada. Se você selecionar a opção Publicar, no Construtor de Topologias, essas etapas entrarão em vigor: as alterações serão publicadas (gravadas no Repositório de Gerenciamento Central) e a nova topologia será habilitada.

O cmdlet Publish-CsTopology não é mais a maneira recomendada de publicar topologias criadas usando-se Construtor de Topologias. Em vez disso, a publicação deve ser feita dentro do Construtor de Topologias, usando as etapas destacadas no parágrafo anterior. Isso ocorre porque o Construtor de Topologias agora usa o formato de arquivo XML (.tbxml) de Construtor de Topologias; esse formato de arquivo não pode ser publicado usando-se Publish-CsTopology. A única coisa que pode ser feita com Publish-CsTopology é publicar novamente uma topologia recuperada usando-se o cmdlet Get-CsTopology. Depois de publicar a topologia dessa maneira, será necessário reconfigurar os URLs simples.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Publish-CsTopology: RTCUniversalServerAdmins. No entanto, se as permissões de definição não forem delegadas, você precisará ser um administrador de domínio para executar Publish-CsTopology. Para conceder a RTCUniversalServerAdmins o direito de usar o cmdlet Publish-CsTopology de fato, será necessário executar o cmdlet Grant-CsSetupPermission em todos os contêineres do Active Directory que contiverem computadores executando serviços do Lync Server. Observe que essa restrição também se aplica à habilitação da topologia no Construtor de Topologias. Se as permissões não forem delegadas usando-se Set-CsSetupPermission, apenas um administrador de domínio poderá publicar uma topologia no Construtor de Topologias.

Parâmetros

Parâmetro Obrigatório Digite Descrição

FileName

Obrigatório

Cadeia de caracteres

Caminho completo até o arquivo XML que contém as informações da nova topologia.

BackupFileName

Opcional

Cadeia de caracteres

Caminho completo até o arquivo de backup criado automaticamente quando se executa Publish-CsTopology. Se esse parâmetro não for especificado, Publish-CsTopology criará um arquivo de backup na pasta temporária (%temp%), semelhante a: Publish-CsTopology-Backup-[2010_10_01][08_30_00]. Nesse nome de arquivo, 2010_10_01 representa a data em que ocorreu a publicação: ano (2010), mês (10) e dia (01). Além disso, 08_30_00 representa a hora do dia em que a publicação foi feita: hora (08), minutos (30) e segundos (00).

Document

Opcional

Objeto System.XML.Linq.XElement

Permite publicar um elemento XML em vez de um arquivo XML. Esse elemento XML deve ser configurado como um objeto System.XML.Linq.XElement.

FinalizeUninstall

Opcional

Parâmetro de opção

Usado somente quando o Lync Server 2010 é desinstalado. Depois que o Servidor de Gerenciamento Central for removido, use Publish-CsTopology e o parâmetro FinalizeUninstall para publicar uma topologia vazia. Entre outras coisas, isso remove todas as entradas do Active Directory para o Servidor de Gerenciamento Central.

GlobalCatalog

Opcional

Cadeia de caracteres

Nome de domínio totalmente qualificado (FQDN) de um servidor de catálogo global no domínio. Esse parâmetro não será necessário se você estiver executando Publish-CsTopology em um computador com uma conta no seu domínio.

GlobalSettingsDomainController

Opcional

Cadeia de caracteres

FQDN de um controlador de domínio onde estão armazenadas as definições globais. Se as definições globais estiverem armazenadas no contêiner Sistema do Serviços de Domínio Active Directory (AD DS), este parâmetro deverá apontar para o controlador de domínio raiz. Se as definições globais estiverem armazenadas no contêiner Configuration, qualquer controlador de domínio poderá ser utilizado e este parâmetro poderá ser omitido.

SkipPrepareCheck

Opcional

Booleano

Se for definido como True ($True), Publish-CsTopology irá ignorar a verificação de preparo inicial.

Force

Opcional

Parâmetro de opção

Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer durante a execução do comando.

Report

Opcional

Cadeia de caracteres

Permite especificar o caminho do arquivo de log criado quando o cmdlet for executado. Por exemplo: -Report "C:\Logs\Publish_Topology.html"

WhatIf

Opcional

Parâmetro de opção

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

Parâmetro de opção

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Nenhuma. Publish-CsTopology não aceita a entrada canalizada.

Tipos de Retorno

Nenhuma. Em vez disso, o Publish-CsTopology publica instâncias do objeto Microsoft.Rtc.Management.Deploy.Internal.DefaultTopology.

Exemplo

-------------------------- Exemplo 1 --------------------------

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

O comando exibido no Exemplo 1 recupera e depois republica a topologia atual. Para realizar essas tarefas, o primeiro comando no exemplo usa Get-CsTopology e o parâmetro AsXml, para recuperar a topologia atual. Utiliza-se o símbolo de redirecionamento do Windows PowerShell > para salvar os dados recuperados em um arquivo denominado C:\Topologies\Topology.xml (observe também que o método ToString é usado para converter a topologia recuperada em um valor de cadeia de caracteres). O segundo comando no exemplo usa Publish-CsTopology para republicar a topologia recém-recuperada.