Get-CsWindowsService
Dernière rubrique modifiée : 2012-03-23
Get-CsWindowsService retourne des informations détaillées sur les composants de Microsoft Lync Server 2010 s’exécutant en tant que services Windows.
Syntaxe
Get-CsWindowsService [-Name <String>] [-ComputerName <String>] [-ExcludeActivityLevel <SwitchParameter>] [-Report <String>]
Description détaillée
De nombreux composants de Lync Server 2010 s’exécutent en tant que services Windows standard. Par exemple, l’application Intendant Conférence de Lync Server est en fait un service RTCCAA. La cmdlet Get-CsWindowsService vous permet d’extraire des informations détaillées sur ces services Lync Server uniquement. Cette cmdlet a en effet été conçue pour ignorer tout service ne faisant pas partie de Lync Server.
Le fait que la cmdlet Get-CsWindowsService écarte automatiquement les services ne faisant pas partie de Lync Server constitue un avantage par rapport à la cmdlet Get-Service générique fournie dans la cadre de Windows PowerShell. En outre, il existe une autre raison d’utiliser Get-CsWindowsService si vous devez récupérer des informations pour un service Lync Server : Get-CsWindowsService retourne des données utiles que ne retourne pas Get-Service. Par exemple, en retournant des informations sur le service Intendant Conférence de Lync Server, Get-CsWindowsService retourne le nombre d’appels simultanés gérés par le service (service Niveau d’activité). Get-Service n’effectue pas cette action.
Par défaut, Get-CsWindowsService s’exécute sur l’ordinateur local. Toutefois, en incluant le paramètre ComputerName, vous pouvez retourner des informations sur les services Lync Server s’exécutant sur un ordinateur distant.
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-CsWindowsService : RTCUniversalServerAdmins. Pour pouvoir exécuter cette cmdlet, vous devez également appartenir au groupe Utilisateurs de l’Analyseur de performances sur l’ordinateur de destination. 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-CsWindowsService"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Name |
Facultatif |
Chaîne |
Nom du service pour lequel vous voulez retourner des informations. Notez que vous devez utiliser le nom de service (par exemple, RTCCAA) que vous souhaitez utiliser et non son nom complet. Vous ne pouvez transmettre qu’un seul nom de service au paramètre Name. En outre, vous ne pouvez pas utiliser de caractères génériques dans le nom de service. Notez également que Get-CsWindowsService ne peut retourner des informations que pour les services Lync Server. Vous ne pouvez pas utiliser cette cmdlet pour retourner des informations sur d’autres services Windows. Pour ces services, vous devrez recourir à la cmdlet Windows PowerShell Get-Service. Si vous n’incluez pas ce paramètre, Get-CsWindowsService retourne des informations sur tous vos services Lync Server. |
ComputerName |
Facultatif |
Chaîne |
Nom de l’ordinateur distant à partir duquel les informations de services sont récupérées. Si ce paramètre n’est pas inclus, Get-CsWindowsService retourne des informations sur les services Lync Server exécutés sur l’ordinateur local. L’ordinateur distant doit être référencé à l’aide de son nom de domaine complet (FQDN). Par exemple, atl-mcs-001.litwareinc.com. |
ExcludeActivityLevel |
Facultatif |
Paramètre de commutateur |
S’il est inclus, ce paramètre force Get-CsWindowsService à ne retourner que le statut de service et non le niveau d’activité du service. |
Report |
Facultatif |
Chaîne |
Chemin vers un fichier HTML dans lequel les informations d’erreurs peuvent être stockées. Si ce paramètre est inclus, toute erreur se produisant durant l’exécution de cette cmdlet sera consignée dans ce fichier spécifique (par exemple : C:\Logs\Service_report.html). |
Types d’entrées
Aucun. Get-CsWindowsService n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Get-CsWindowsService retourne des instances de l’objet Microsoft.Rtc.Management.Deployment.Core.NTService.
Exemple
-------------------------- Exemple 1 ------------------------
Get-CsWindowsService
La commande illustrée dans l’exemple 1 retourne des informations sur les services Lync Server installés sur l’ordinateur local. Cela s’effectue par l’appel de Get-CsWindowsService sans paramètres.
-------------------------- Exemple 2 ------------------------
Get-CsWindowsService | Format-List
L’exemple 2 retourne également des informations relatives aux services Lync Server sur l’ordinateur local. Dans ce cas toutefois, les données s’affichent dans un format de liste. (Vous pouvez notamment afficher toutes les valeurs de propriété de chaque service. Dans la vue tabulaire par défaut, seul un sous-ensemble de valeurs de propriété s’affiche.) Pour effectuer cette tâche, Get-CsWindowsService est d’abord appelée, puis les informations qui en résultent sont redirigées vers la cmdlet Format-List.
-------------------------- Exemple 3 ------------------------
Get-CsWindowsService -Name "RTCSrv"
L’exemple 3 retourne des informations pour un seul service Lync Server : le service portant le nom RTCSrv.
-------------------------- Exemple 4 ------------------------
Get-CsWindowsService -Name "RTCSrv" | Select-Object -ExpandProperty RoleName
Dans l’exemple 4, des informations détaillées s’affichent pour tous les rôles de service gérés par le service RTCSrv. Pour effectuer cette tâche, Get-CsWindowsService est d’abord utilisée pour retourner des informations sur le service RTCSrv. Ces informations sont ensuite redirigées vers la cmdlet Select-Object qui utilise le paramètre ExpandProperty pour afficher tous les rôles gérés par le service RTCSrv. Notez que cette commande retourne un message d’erreur si le service n’a pas de nom de rôle.
-------------------------- Exemple 5 ------------------------
Get-CsWindowsService -Computer atl-cs-001.litwareinc.com
La commande illustrée dans l’exemple 5 retourne des informations sur les services Lync Server installés sur l’ordinateur distant atl-cs-001.litwareinc.com. Cela s’effectue par l’inclusion du paramètre ComputerName suivi du nom de domaine complet de l’ordinateur distant.
-------------------------- Exemple 6 ------------------------
Get-CsWindowsService -Report C:\Logs\Services.html
La commande ci-dessus retourne des informations relatives à tous les services Lync Server installés sur l’ordinateur local. En outre, le paramètre Report est inclus afin de sauvegarder les informations d’erreur dans le fichier C:\Logs\Services.html. Si Get-CsWindowsService rencontre un problème lors de la récupération des données de service, les informations s’y rapportant sont enregistrées dans le fichier Services.html.
-------------------------- Exemple 7 ------------------------
Get-CsWindowsService | Where-Object {$_.Status -eq "Running"}
Dans l’exemple 7, les informations retournées ne concernent que les services Lync Server en cours d’exécution sur l’ordinateur local. Pour ce faire, la commande utilise d’abord Get-CsWindowsService pour retourner une collection de tous les services Lync Server, en cours d’exécution ou non. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne uniquement les services dont la propriété Status est égale à Running.
-------------------------- Exemple 8 ------------------------
Get-CsWindowsService | Where-Object {$_.DisplayName -like "*Application Sharing*"}
L’exemple 8 explique comment récupérer les informations d’un service en particulier, même si vous ne connaissez pas son nom (RTCASMCU, dans le cas présent). Pour effectuer cette tâche, Get-CsWindowsService est d’abord appelée sans paramètres. Cette opération retourne une collection de tous les services Lync Server présents sur l’ordinateur local. Cette collection est ensuite redirigée vers la cmdlet Where-Object, qui choisit uniquement le service dont la propriété DisplayName inclut (-like) la valeur de chaîne "Application Sharing". Résultat : les informations qui s’affichent concernent le service de conférence de partage d’applications de Lync Server.
-------------------------- Exemple 9 ------------------------
Get-CsWindowsService | Where-Object {$_.RoleName -contains "ApplicationServer"}
L’exemple 9 retourne des informations sur les services hébergeant le rôle Application Server. Pour ce faire, la commande appelle d’abord Get-CsWindowsService pour retourner une collection de tous les services Lync Server sur l’ordinateur local. Cette collection est ensuite redirigée vers la cmdlet Where-Object, qui sélectionne les services dont la propriété RoleName inclut (-contains) le rôle ApplicationServer.