Condividi tramite

  • Articolo

Publish-CsTopology

 

Ultima modifica dell'argomento: 2012-03-25

Pubblica la topologia di Microsoft Lync Server 2010 recuperata utilizzando il cmdlet Get-CsTopology.

Sintassi

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

Descrizione dettagliata

Dopo aver installato Lync Server 2010, può accadere di dover apportare modifiche all'infrastruttura di Lync Server, ad esempio allo scopo di aggiungere un nuovo sito, eliminare un pool di registrazione esistente o aggiungere un ulteriore Server di archiviazione. Tali modifiche relative all'infrastruttura devono essere apportate mediante lo Generatore di topologie. Dopo aver effettuato le modifiche nello Generatore di topologie, è possibile pubblicarle e abilitarle utilizzando lo stesso strumento. Questi ultimi due passaggi sono molto importanti. Sebbene con lo Generatore di topologie sia possibile apportare tutte le modifiche desiderate, l'infrastruttura di Lync Server verrà modificata e le modifiche diventeranno effettive solo dopo la pubblicazione delle stesse e l'abilitazione della nuova topologia.

Con la pubblicazione delle modifiche, le nuove informazioni, ad esempio un nuovo sito o un nuovo ruolo del server, vengono scritte nell'archivio di gestione centrale. Questi oggetti nuovi, o appena modificati, tuttavia non vengono aggiunti immediatamente alla topologia, ma solo dopo l'abilitazione della topologia aggiornata. Se si seleziona l'opzione Pubblicazione nello Generatore di topologie, verranno effettuate le due operazioni seguenti: le modifiche verranno pubblicate, ovvero scritte nell'archivio di gestione centrale, e la nuova topologia verrà abilitata.

Il cmdlet Publish-CsTopology non rappresenta più il metodo consigliato per pubblicare le topologie create utilizzando lo Generatore di topologie. È invece preferibile effettuare la pubblicazione all'interno dello Generatore di topologie eseguendo le operazioni descritte nel paragrafo precedente. Ciò è dovuto al fatto che lo Generatore di topologie ora utilizza un proprio formato di file XML (con estensione tbxml) che non può essere pubblicato mediante Publish-CsTopology. L'unica operazione consentita con Publish-CsTopology è la ripubblicazione di una topologia recuperata utilizzando il cmdlet Get-CsTopology. Dopo avere pubblicato la topologia in questo modo, sarà necessario riconfigurare gli URL semplici.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Publish-CsTopology i membri dei seguenti gruppi: RTCUniversalServerAdmins. Se però le autorizzazioni di installazione non sono state delegate, sarà possibile eseguire Publish-CsTopology solo se si è amministratori di dominio. Per conferire al gruppo RTCUniversalServerAdmins il diritto di utilizzare effettivamente il cmdlet Publish-CsTopology, è necessario eseguire il cmdlet Grant-CsSetupPermission per ogni contenitore di Active Directory con computer che eseguono servizi di Lync Server. Tale restrizione si applica anche all'abilitazione di una topologia mediante lo Generatore di topologie. Se le autorizzazioni non sono state delegate utilizzando Set-CsSetupPermission, solo un amministratore di dominio potrà pubblicare una topologia mediante lo Generatore di topologie.

Parametri

Parametro Obbligatorio Tipo Descrizione

FileName

Obbligatorio

Stringa

Percorso completo del file XML contenente le informazioni della nuova topologia.

BackupFileName

Facoltativo

Stringa

Percorso completo del file di backup creato automaticamente quando si esegue Publish-CsTopology. Se questo parametro non viene specificato, Publish-CsTopology creerà nella cartella Temp (%temp%) un file di backup simile al seguente: Publish-CsTopology-Backup-[2010_10_01][08_30_00]. Nel nome del file 2010_10_01 rappresenta la data in cui è avvenuta la pubblicazione: anno (2010), mese (10) e giorno (01). 08_30_00 inoltre rappresenta l'ora del giorno in cui è avvenuta la pubblicazione: ore (08), minuti (30) e secondi (00).

Document

Facoltativo

Oggetto System.XML.Linq.XElement

Consente di pubblicare un elemento XML anziché un file XML. Questo elemento XML deve essere configurato come oggetto System.XML.Linq.XElement.

FinalizeUninstall

Facoltativo

Parametro opzionale

Utilizzato solo quando si disinstalla Lync Server 2010. Dopo la rimozione del server di gestione centrale, utilizzare Publish-CsTopology e il parametro FinalizeUninstall per pubblicare una topologia vuota. Tra le altre cose, questa operazione comporta la rimozione di tutte le voci di Active Directory per il server di gestione centrale.

GlobalCatalog

Facoltativo

Stringa

Nome di dominio completo (FQDN) di un server di catalogo globale nel dominio in uso. Questo parametro non è obbligatorio se si esegue Publish-CsTopology in un computer con un account nel dominio.

GlobalSettingsDomainController

Facoltativo

Stringa

Nome di dominio completo di un controller di dominio in cui sono archiviate le impostazioni globali. Se le impostazioni globali sono archiviate nel contenitore di sistema in Servizi di dominio Active Directory, questo parametro dovrà puntare al controller di dominio radice. Se le impostazioni globali sono archiviate nel contenitore della configurazione, sarà possibile utilizzare qualsiasi controller di dominio e omettere questo parametro.

SkipPrepareCheck

Facoltativo

Booleano

Se impostato su True ($True), Publish-CsTopology ignorerà il controllo di preparazione iniziale.

Force

Facoltativo

Parametro opzionale

Consente di non visualizzare i messaggi relativi agli errori non irreversibili che possono verificarsi durante l'esecuzione del comando.

Report

Facoltativo

Stringa

Consente di specificare un percorso per il file di registro creato durante l'esecuzione del cmdlet. Ad esempio: -Report "C:\Logs\Publish_Topology.html"

WhatIf

Facoltativo

Parametro opzionale

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Confirm

Facoltativo

Parametro opzionale

Viene visualizzata una richiesta di conferma prima di eseguire il comando.

Tipi di input

Nessuno. Publish-CsTopology non accetta l'input da pipeline.

Tipi restituiti

Nessuno. Publish-CsTopology piuttosto pubblica le istanze dell'oggetto Microsoft.Rtc.Management.Deploy.Internal.DefaultTopology.

Esempio

-------------------------- Esempio 1 --------------------------

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

I comandi mostrati nell'esempio 1 recuperano e quindi ripubblicano la topologia corrente. Per eseguire queste attività, nel primo comando dell'esempio vengono utilizzati Get-CsTopology e il parametro AsXml per recuperare la topologia corrente. Il simbolo di reindirizzamento di Windows PowerShell > viene quindi utilizzato per salvare i dati recuperati in un file denominato C:\Topologies\Topology.xml. Si noti inoltre che viene utilizzato il metodo ToString per convertire in un valore stringa la topologia recuperata. Nel secondo comando dell'esempio viene quindi utilizzato Publish-CsTopology per ripubblicare la topologia appena recuperata.