Get-CsTopology
Dernière rubrique modifiée : 2012-03-23
Retourne des informations sur votre infrastructure Microsoft Lync Server 2010, y compris sur les domaines internes, les sites, les clusters, les ordinateurs, les services et les instances SQL Server principales.
Syntaxe
Get-CsTopology [-AsXml <SwitchParameter>] [-LocalStore <SwitchParameter>]
Description détaillée
La cmdlet Get-CsTopology retourne des informations sur la façon dont Lync Server 2010 a été configuré. Lorsque vous l’appelez sans aucun paramètre supplémentaire, cette cmdlet fournit une vue d’ensemble de votre infrastructure Lync Server. Dans le cas présent, elle offre une vue générale de vos domaines, sites et ordinateurs sur lesquels sont exécutés des services et des rôles serveur Lync Server. Vous pouvez également transmettre la sortie de la cmdlet Get-CsTopology à la cmdlet Select-Object, ce qui vous permet d’accéder à des informations détaillées sur une partie de votre topologie. Par exemple, la commande qui suit apporte des informations détaillées sur les instances SQL Server employées dans Lync Server :
Get-CsTopology | Select-Object –ExpandProperty SqlInstances
Vous pouvez aussi vous servir du paramètre AsXml pour retourner des informations détaillées sur la totalité de votre topologie au format XML.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Get-CsTopology : RTCUniversalUserAdmins, RTCUniversalServerAdmins.
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
AsXml |
Facultatif |
Paramètre de commutateur |
Renvoie des informations de topologie au format XML. En associant la cmdlet Get-CsTopology, le paramètre AsXml et la cmdlet Out-File, vous pouvez exporter votre topologie vers un fichier XML. |
LocalStore |
Facultatif |
Paramètre de commutateur |
Récupère les données de topologie depuis le réplica local du magasin central de gestion au lieu du magasin central de gestion lui-même. |
Types d’entrées
Aucun. Get-CsTopology n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Get-CsTopology renvoie les instances de l’objet Microsoft.Rtc.Management.Deploy.Internal.DefaultTopology.
Exemple
-------------------------- Exemple 1 ------------------------
Get-CsTopology
La commande ci-dessus retourne des données détaillées complètes sur votre topologie Lync Server. Pour ce faire, la cmdlet Get-CsTopology est appelée sans aucun paramètre supplémentaire.
-------------------------- Exemple 2 ------------------------
Get-CsTopology | Select-Object -ExpandProperty Machines
L’exemple 2 renvoie des informations sur les ordinateurs détectés dans votre topologie Lync Server. Pour cela, la commande appelle d’abord la cmdlet Get-CsTopology pour retourner la topologie Lync Server complète. Ces informations sont ensuite redirigées vers la cmdlet Select-Object qui utilise le paramètre ExpandProperty pour extraire et afficher des informations détaillées pour tous les ordinateurs inclus dans cette topologie.
-------------------------- Exemple 3 ------------------------
Get-CsTopology -AsXML | Out-File C:\Logs\Topology.xml
La commande affichée dans l’exemple 3 renvoie des informations sur votre topologie Lync Server, puis enregistre ces informations dans un fichier XML. Pour réaliser cette tâche, la commande appelle d’abord la cmdlet Get-CsTopology avec le paramètre AsXml et les données sont alors renvoyées au format XML. Ces données mises en forme sont enfin redirigées vers la cmdlet Out-File qui enregistre les informations dans le fichier C:\Logs\Topology.xml.