Get-CsService
Dernière rubrique modifiée : 2012-03-23
Retourne des informations sur les services et les rôles serveur utilisés dans votre infrastructure Microsoft Lync Server 2010. Un service est une instance d’un rôle qui a été déployé dans un pool Lync Server 2010. Par exemple, vous pouvez disposer d’un pool d’ordinateurs tous équipés du service Serveur de surveillance.
Syntaxe
Get-CsService [-Identity <XdsGlobalRelativeIdentity>] [-PoolFqdn <String>]
Get-CsService [-ApplicationServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-ApplicationDatabase <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-ArchivingServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-ArchivingDatabase <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-CentralManagement <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-CentralManagementDatabase <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-ConferencingServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-Director <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-EdgeServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-PoolFqdn <String>] [-TrustedApplicationPool <SwitchParameter>]
Get-CsService [-FileStore <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-ManagementServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-MediationServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-MonitoringServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-MonitoringDatabase <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-PoolFqdn <String>] [-PstnGateway <SwitchParameter>]
Get-CsService [-PoolFqdn <String>] [-ProvisionServer <SwitchParameter>]
Get-CsService [-PoolFqdn <String>] [-ProvisionDatabase <SwitchParameter>]
Get-CsService [-PoolFqdn <String>] [-Registrar <SwitchParameter>]
Get-CsService [-PoolFqdn <String>] [-UserServer <SwitchParameter>]
Get-CsService [-PoolFqdn <String>] [-UserDatabase <SwitchParameter>]
Get-CsService [-PoolFqdn <String>] [-WebServer <SwitchParameter>]
Get-CsService [-Filter <String>] [-PoolFqdn <String>]
Description détaillée
Les fonctionnalités de Lync Server 2010 sont généralement matérialisées sous la forme de services ou de rôles serveur. Par exemple, il est possible de configurer Lync Server pour enregistrer automatiquement une transcription de chaque session de messagerie instantanée ayant lieu dans votre organisation. Pour cela, vous devez installer le rôle serveur serveur d’archivage. Les services et les rôles serveur peuvent être configurés au moment de l’installation même de Lync Server ou bien être configurés une fois le logiciel en cours de fonctionnement.
La cmdlet Get-CsService vous permet de retourner des informations sur les rôles serveur et les services en cours d’exécution dans votre organisation. Si vous l’appelez sans paramètre, Get-CsService retourne des informations détaillées sur l’ensemble de vos services et rôles serveur. Vous pouvez également limiter les données retournées à un pool en particulier à l’aide du paramètre PoolFqdn. En outre, il est possible d’utiliser plusieurs paramètres de commutateur afin de limiter les données retournées pour un type de service spécifique. (Un paramètre de commutateur ne nécessite aucune valeur de paramètre.) Par exemple, la commande suivante retourne des informations sur tous vos serveurs d’archivage :
Get-CsService –ArchivingServer
Notez que vous ne pouvez utiliser qu’un seul de ces paramètres de commutateur par commande. La commande suivante, qui tente de retourner des informations sur les serveurs d’archivage et les serveurs de surveillance à la fois, se solde par un échec :
Get-CsService –ArchivingServer –MonitoringServer
Pour retourner des informations sur plusieurs rôles serveur, utilisez la cmdlet Get-CsService pour retourner une collection complète de données de service, puis redirigez ces données vers la cmdlet Where-Object :
Get-CsService | Where-Object {$_.Role –eq "ArchivingServer" –or $_.Role –eq "MonitoringServer"}
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-CsService : RTCUniversalUserAdmins, RTCUniversalServerAdmins. Pour retourner une liste de tous les rôles RBAC (Contrôle d’accès basé sur un rôle) auxquels cette cmdlet a été affectée (y compris les rôles RBAC personnalisés créés par vos soins), exécutez la commande suivante à l’invite Windows PowerShell :
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsService"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
XdsIdentity |
Identificateur unique du service ou rôle serveur spécifique à retourner. Par exemple : -Identity "Registrar:atl-cs-001.litwareinc.com". |
Filter |
Facultatif |
Chaîne |
Permet d’utiliser des caractères génériques pour spécifier le ou les services à retourner. Vous ne pouvez pas utiliser à la fois les paramètres Filter et Identity dans la même commande. |
ApplicationDatabase |
Facultatif |
Paramètre de commutateur |
Retourne des informations sur les bases de données d’applications utilisées au sein de votre organisation. Les bases de données d’applications sont utilisées par le service d’application. |
ApplicationServer |
Facultatif |
Paramètre de commutateur |
Retourne des informations sur le service d’application. Le service d’application permet d’exécuter des applications conçues à l’aide de Microsoft Unified Communications Managed API (UCMA). |
ArchivingDatabase |
Facultatif |
Paramètre de commutateur |
Retourne des informations sur les bases de données d’archivage utilisées au sein de votre organisation. Les bases de données d’archivage stockent les transcriptions des sessions de messagerie instantanée. |
ArchivingServer |
Facultatif |
Paramètre de commutateur |
Retourne des informations sur les serveurs d’archivage utilisés au sein de votre organisation. Les serveurs d’archivage vous permettent d’enregistrer les transcriptions des sessions de messagerie instantanée. |
CentralManagement |
Facultatif |
Paramètre de commutateur |
Retourne des informations sur le service de gestion centralisée utilisé au sein de votre organisation. Le service de gestion centralisée sert à envoyer des données de configuration aux ordinateurs sur lesquels les services Lync Server 2010 sont exécutés. |
CentralManagementDatabase |
Facultatif |
Paramètre de commutateur |
Retourne des informations sur le magasin central de gestion utilisé au sein de votre organisation. Le magasin central de gestion conserve les informations de configuration de Lync Server. |
ConferencingServer |
Facultatif |
Paramètre de commutateur |
Retourne des informations sur le service de conférence A/V utilisé au sein de votre organisation. Le service de conférence A/V est utilisé pour la mise en place de réunions et de conférences. |
Director |
Facultatif |
Paramètre de commutateur |
Retourne des informations sur les directeurs utilisés au sein de votre organisation. Les directeurs sont chargés de gérer les requêtes des utilisateurs et leur authentification mais ils n’hébergent pas de comptes d’utilisateurs. Ils sont généralement utilisés pour gérer des requêtes émanant d’utilisateurs externes. |
EdgeServer |
Facultatif |
Paramètre de commutateur |
Retourne des informations sur les serveurs de périphérie utilisés au sein de votre organisation. Les serveurs de périphérie fournissent la connectivité nécessaire entre votre réseau interne et Internet. |
FileStore |
Facultatif |
Paramètre de commutateur |
Retourne des informations sur les magasins de fichiers utilisés au sein de votre organisation. Le magasin de fichiers est utilisé pour gérer des fichiers Lync Server de même que les fichiers audio utilisés par le service d’annonce. |
ManagementServer |
Facultatif |
Paramètre de commutateur |
Retourne des informations sur le serveur de gestion centralisée utilisé au sein de votre organisation. Le serveur de gestion centralisée intervient généralement au même endroit que les serveurs frontaux et gère l’accès aux informations dans le magasin central de gestion. |
MediationServer |
Facultatif |
Paramètre de commutateur |
Retourne des informations sur les serveurs de médiation utilisés au sein de votre organisation. Les serveurs de médiation créent un pont entre votre réseau Enterprise Voice et le réseau téléphonique commuté (PSTN). |
MonitoringServer |
Facultatif |
Paramètre de commutateur |
Retourne des informations sur les serveurs de surveillance utilisés au sein de votre organisation. Les serveurs de surveillance sont utilisés pour assurer le suivi de l’utilisation téléphonique et la qualité des appels Enterprise Voice. |
MonitoringDatabase |
Facultatif |
Paramètre de commutateur |
Retourne des informations sur les bases de données de surveillance utilisées au sein de votre organisation. Les bases de données de surveillance stockent des informations sur l’utilisation téléphonique et la qualité des appels Enterprise Voice. |
PoolFqdn |
Facultatif |
Chaîne |
Nom de domaine complet (FQDN) du pool hébergeant le service ou le rôle serveur. Si vous utilisez le paramètre PoolFqdn sans spécifier de paramètre propre à un service, tous les services et rôles serveur détectés dans ce pool seront retournés. |
ProvisionServer |
Facultatif |
Paramètre de commutateur |
Retourne des informations sur les serveurs de mise en service utilisés au sein de votre organisation. Le service Serveur de mise en service est utilisé pour gérer des certificats Lync Server. |
ProvisionDatabase |
Facultatif |
Paramètre de commutateur |
Retourne des informations sur les bases de données de mise en service utilisées au sein de votre organisation. Les bases de données de mise en service gèrent les informations sur les certificats Lync Server. |
PstnGateway |
Facultatif |
Paramètre de commutateur |
Retourne des informations sur les passerelles PSTN (réseau téléphonique commuté) utilisées au sein de votre organisation. Les passerelles PSTN convertissent les signaux des périphériques Enterprise Voice en signaux que les périphériques PSTN peuvent interpréter, et inversement. |
Registrar |
Facultatif |
Paramètre de commutateur |
Retourne des informations sur les serveurs d’inscriptions utilisés au sein de votre organisation. Les serveurs d’inscriptions sont utilisés pour authentifier les utilisateurs et assurer le suivi de l’état actuel d’un utilisateur. |
TrustedApplicationPool |
Facultatif |
Paramètre de commutateur |
Retourne des informations sur les pools d’applications approuvées utilisés au sein de votre organisation. Les pools d’applications approuvées hébergent des ordinateurs sur lesquels des applications approuvées sont exécutées. |
UserDatabase |
Facultatif |
Paramètre de commutateur |
Retourne des informations sur la base de données utilisateur utilisée au sein de votre organisation. Les bases de données utilisateur stockent des données nécessaires au service User Server. |
UserServer |
Facultatif |
Paramètre de commutateur |
Retourne des informations sur les services d’utilisateurs utilisés au sein de votre organisation. Les services d’utilisateurs fournissent des informations sur la réplication d’utilisateurs, la mise en service intrabande, la publication et la notification de présence, et l’échange de cartes de visite. |
WebServer |
Facultatif |
Paramètre de commutateur |
Retourne des informations sur les services Web utilisés au sein de votre organisation. Les services Web hébergent des applications Web comme le service Carnet d’adresses. |
Types d’entrées
Aucun. Get-CsService n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Get-CsService retourne différents objets fondés sur les paramètres utilisés lors de l’appel de la cmdlet. Par exemple, si vous incluez le paramètre MonitoringDatabase, Get-CsService retourne des instances de l’objet Microsoft.Rtc.Management.Xds.DisplayMonitoringDatabase. Pour déterminer les objets retournés au moyen d’autres paramètres, appelez la cmdlet Get-CsService à l’aide de l’un de ces paramètres, puis redirigez l’objet retourné vers la cmdlet Get-Member. Par exemple : Get-CsService -Registrar | Get-Member.
Exemple
-------------------------- Exemple 1 ------------------------
Get-CsService
La commande présentée dans l’exemple 1 retourne des informations sur tous les services et rôles serveur Lync Server 2010 en cours d’exécution dans votre organisation.
-------------------------- Exemple 2 ------------------------
Get-CsService -ApplicationServer
L’exemple 2 retourne uniquement des informations sur le service d’application. Pour retourner des informations sur d’autres services/rôles serveur, il vous suffit d’utiliser le paramètre adéquat. Par exemple, la commande suivante retourne des informations sur le magasin de fichiers :
Get-CsService -FileStore
-------------------------- Exemple 3 ------------------------
Get-CsService -PoolFqdn "atl-cs-001.litwareinc.com" | Select-Object Identity
La commande ci-dessus renvoie le paramètre Identity de chaque service figurant dans le pool atl-cs-001.litwareinc.com. Pour réaliser cette tâche, la commande appelle d’abord Get-CsService et le paramètre PoolFqdn afin de retourner uniquement les services et rôles serveur détectés dans le pool atl-cs-001.litwareinc.com. Cette collection est ensuite redirigée vers la cmdlet Select-Object qui renvoie le paramètre Identity de chaque élément de la collection.
-------------------------- Exemple 4 ------------------------
Get-CsService | Where-Object {$_.SiteID -eq "site:Redmond"}
Dans l’exemple 4, des informations sont retournées pour tous les services/rôles serveur détectés sur le site de Redmond. Cette opération est effectuée en appelant d’abord la cmdlet Get-CsService sans aucun paramètre pour retourner une collection de tous les services et rôles serveur en cours d’utilisation dans l’organisation. Ces données sont ensuite redirigées vers la cmdlet Where-Object qui sélectionne uniquement les éléments dont la propriété SiteID est égale à site:Redmond.
-------------------------- Exemple 5 ------------------------
Get-CsService | Where-Object {$_.DependentServiceList -like "*Registrar*"}
La commande présentée dans l’exemple 5 retourne des informations sur tous les services répertoriant le service Serveur d’inscriptions en tant que service dépendant. Pour cela, la cmdlet Get-CsService est appelée afin de retourner une collection de tous les services et rôles serveur actuellement utilisés. Cette collection est ensuite redirigée vers Where-Object qui sélectionne chaque élément dont la propriété DependentServiceList comprend la valeur de chaîne « Registrar ». Les critères de la cmdlet Where-Object sont précisés avec l’opérateur -like et le caractère générique « *Registrar* ».