Partager via

  • Article

Publish-CsTopology

 

Dernière rubrique modifiée : 2012-03-25

Publie la topologie Microsoft Lync Server 2010 extraite par la cmdlet Get-CsTopology.

Syntaxe

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

Description détaillée

Une fois que vous avez installé Lync Server 2010, vous devrez peut-être apporter des modifications à l’infrastructure Lync Server : ajouter un nouveau site, supprimer un pool de serveurs d’inscriptions ou ajouter un autre serveur d’archivage, par exemple. Vous devez utiliser l’Générateur de topologies pour effectuer ces changements. Après avoir effectué les modifications dans l’Générateur de topologies, vous pourrez alors les publier et les activer à l’aide de ce même outil. Ces deux dernières étapes sont très importantes : vous pouvez apporter autant de modifications que vous le souhaitez à l’aide de l’Générateur de topologies, mais pour que celles-ci prennent effet et que votre infrastructure Lync Server soit modifiée, il est impératif que ces modifications soient préalablement publiées et que la nouvelle topologie soit activée.

Lorsque les modifications sont publiées, les nouvelles informations (par exemple, un nouveau site ou un nouveau rôle serveur) sont écrites dans le magasin central de gestion. Cependant, ces objets nouveaux (ou modifiés) ne rejoignent pas votre topologie immédiatement, mais uniquement lorsque la topologie mise à jour est activée. Si vous sélectionnez l’option Publier dans l’Générateur de topologies, ces deux étapes se produisent : les modifications sont publiées (écrites dans le magasin central de gestion), puis la nouvelle topologie est activée.

La cmdlet Publish-CsTopology n’est plus recommandée pour publier des topologies créées à l’aide de l’Générateur de topologies. En effet, il est préférable de procéder à la publication dans l’Générateur de topologies, en suivant les étapes décrites dans le paragraphe précédent. Ceci est dû au fait que l’Générateur de topologies utilise à présent un format de fichier XML (.tbxml) propre à ce même Générateur de topologies et que ce format ne peut pas être publié au moyen de la cmdlet Publish-CsTopology. La cmdlet Publish-CsTopology sert uniquement à republier une topologie extraite à l’aide de la cmdlet Get-CsTopology. Après avoir publié la topologie de cette façon, vous devrez reconfigurer vos URL simples.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Publish-CsTopology : RTCUniversalServerAdmins. Toutefois, si les autorisations de configuration n’ont pas été déléguées; vous devez être administrateur de domaine pour pouvoir exécuter Publish-CsTopology. Pour accorder au groupe RTCUniversalServerAdmins le droit d’utiliser la cmdlet Publish-CsTopology, vous devez exécuter la cmdlet Grant-CsSetupPermission sur le conteneur Active Directory comprenant les ordinateurs exécutant les services Lync Server. Notez que cette restriction s’applique également dans le cadre de l’activation d’une topologie via de l’Générateur de topologies. Si vous n’avez pas délégué d’autorisations à l’aide de Set-CsSetupPermission, alors seul un administrateur de domaine pourra publier une topologie par le biais de l’Générateur de topologies.

Paramètres

Paramètre Obligatoire Type Description

FileName

Obligatoire

Chaîne

Chemin d’accès complet au fichier XML contenant les informations de la nouvelle topologie.

BackupFileName

Facultatif

Chaîne

Chemin d’accès complet au fichier de sauvegarde créé automatiquement lorsque vous exécutez Publish-CsTopology. Si ce paramètre n’est pas spécifié, alors Publish-CsTopology créera un fichier de sauvegarde semblable à celui-ci dans votre dossier temporaire (%temp%) : Publish-CsTopology-Backup-[2010_10_01][08_30_00]. Dans ce nom de fichier, 2010_10_01 représente la date à laquelle cette publication a eu lieu : année (2010), mois (10) et jour (01). En outre, 08_30_00 représente l’heure à laquelle cette publication a eu lieu : heures (08), minutes (30) et secondes (00).

Document

Facultatif

Objet System.XML.Linq.XElement

Permet de publier un élément XML plutôt qu’un fichier XML. Cet élément XML doit être configuré comme un objet System.XML.Linq.XElement.

FinalizeUninstall

Facultatif

Paramètre de commutateur

Utilisé uniquement lors de la désinstallation de Lync Server 2010. Lorsque le serveur de gestion centralisée a été supprimé, utilisez Publish-CsTopology et le paramètre FinalizeUninstall pour publier une topologie vide. Entre autres choses, cela supprime toutes les entrées Active Directory du serveur de gestion centralisée.

GlobalCatalog

Facultatif

Chaîne

Nom de domaine complet (FQDN) d’un serveur de catalogue global dans votre domaine. Ce paramètre n’est pas obligatoire si vous exécutez Publish-CsTopology sur un ordinateur possédant un compte dans votre domaine.

GlobalSettingsDomainController

Facultatif

Chaîne

Nom de domaine complet (FQDN) d’un contrôleur de domaine dans lequel les paramètres globaux sont stockés. Si les paramètres globaux sont stockés dans le conteneur Système dans services de domaine Active Directory (AD DS), ce paramètre doit pointer sur le contrôleur de domaine racine. Si les paramètres globaux sont stockés dans le conteneur Configuration, tout contrôleur de domaine peut être utilisé et ce paramètre peut être omis.

SkipPrepareCheck

Facultatif

Booléen

Si défini sur True ($True) Publish-CsTopology ignore sa vérification de préparation initiale.

Force

Facultatif

Paramètre de commutateur

Supprime l’affichage de tous les messages d’erreur récupérable susceptibles d’apparaître lors de l’exécution de la commande.

Report

Facultatif

Chaîne

Permet de spécifier un chemin d’accès au fichier journal créé lors de l’exécution de la cmdlet. Par exemple : -Report "C:\Logs\Publish_Topology.html".

WhatIf

Facultatif

Paramètre de commutateur

Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement.

Confirm

Facultatif

Paramètre de commutateur

Vous demande confirmation avant d’exécuter la commande.

Types d’entrées

Aucun. Publish-CsTopology n’accepte pas la saisie de données transmises via le pipeline.

Types de retours

Aucun. Au lieu de cela, Publish-CsTopology publie des instances de l’objet Microsoft.Rtc.Management.Deploy.Internal.DefaultTopology.

Exemple

-------------------------- Exemple 1 --------------------------

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

Les commandes présentées dans l’exemple 1 récupèrent puis republient la topologie actuelle. Pour effectuer ces tâches, la première commande de l’exemple utilise Get-CsTopology et le paramètre AsXml pour récupérer la topologie actuelle. Ensuite, le symbole de redirection > de Windows PowerShell est utilisé pour enregistrer les données extraites dans le fichier C:\Topologies\Topology.xml. (Notez que la méthode ToString sert à convertir la topologie extraite en une valeur de chaîne.) La seconde commande de l’exemple utilise ensuite Publish-CsTopology pour republier la topologie qui vient d’être extraite.