Stop-CsWindowsService
Dernière rubrique modifiée : 2012-03-27
Stop-CsWindowsService permet d’arrêter un service Microsoft Lync Server 2010.
Syntaxe
Stop-CsWindowsService [-Name <String>] [-ComputerName <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Graceful <SwitchParameter>] [-NoWait <SwitchParameter>] [-Report <String>] [-WhatIf [<SwitchParameter>]]
Stop-CsWindowsService [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Graceful <SwitchParameter>] [-InputObject <NTService>] [-NoWait <SwitchParameter>] [-Report <String>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Bon nombre de composants de Lync Server 2010 s’exécutent en tant que services Windows standard. Par exemple, l’application Intendant Conférence est en fait un service appelé RTCCAA. Si vous devez arrêter un service Lync Server, vous pouvez utiliser la cmdlet Stop-CsWindowsService.
Toutefois, il est à noter que Stop-CsWindowsService ne peut arrêter que des services Lync Server. Une erreur surviendra si vous essayez d’arrêter un service autre que Lync Server (comme le spouleur d’impression) à l’aide de cette cmdlet.
D’un point de vue fonctionnel, Stop-CsWindowsService est très similaire à la cmdlet Windows PowerShell générique Stop-Service. Si vous le souhaitez, vous pouvez aussi utiliser Stop-Service pour arrêter un service Lync Server. Cependant, Stop-CsWindowsService comporte un paramètre ComputerName qui permet d’arrêter facilement un service sur un ordinateur distant : il suffit d’inclure le paramètre ComputerName suivi du nom de domaine complet de l’ordinateur distant. La cmdlet Stop-Service n’a pas de paramètre comparable. De plus, le paramètre Report de la cmdlet Stop-CsWindowsService permet de conserver un journal des erreurs qui pourraient survenir en appelant Stop-CsWindowsService.
Comme son nom l’indique, Stop-CsWindowsService effectue la tâche suivante : il arrête tout service dont l’interruption a été demandée. Il s’agit des services ayant des services dépendants (ne pouvant être exécutés que si le service que vous essayez d’interrompre est en cours d’exécution). Par défaut, si vous essayez d’interrompre un service dont dépendent d’autres services, Stop-CsWindowsService mettra non seulement un terme au service en question, mais aussi aux services dépendants. Pour vous prémunir de résultats indésirables, vous pouvez inclure le paramètre Graceful en appelant Stop-CsWindowsService. Si vous incluez le paramètre Graceful, Stop-CsWindowsService empêchera le service d’accepter toute nouvelle requête. Les demandes de services existantes ne changeront pas, mais les nouvelles demandes seront rejetées. Si les demandes existantes se terminent, elles ne seront pas remplacées. Enfin, toutes les demandes existantes seront satisfaites et le service sera terminé.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Stop-CsWindowsService : RTCUniversalServerAdmins. En outre, vous devez aussi avoir des droits d’administration locale sur l’ordinateur de destination pour pouvoir exécuter cette cmdlet. 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 "Stop-CsWindowsService"}
Paramètres
| Parameter | Obligatoire | Type | Description |
|---|---|---|---|
Name |
Facultatif |
Chaîne |
Nom du service Lync Server que vous voulez arrêter. Notez que vous devez utiliser le nom de service (par exemple, RTCCAA) que vous souhaitez utiliser et non son nom complet. Vous ne pouvez pas transférer de nom de service unique au paramètre Name et vous ne pouvez pas utiliser de caractères génériques dans le nom du service. Utilisez la cmdlet Get-CsWindowsService pour récupérer des noms de service. Gardez à l’esprit que Stop-CsWindowsService ne peut arrêter que des services Lync Server. Vous ne pouvez pas utiliser cette cmdlet pour arrêter d’autres services Windows. Pour ces services, vous pouvez utiliser la cmdlet Stop-Service de Windows PowerShell. |
ComputerName |
Facultatif |
Chaîne |
Nom de l’ordinateur distant qui exécutait le service à arrêter. Si ce paramètre n’est pas inclus, alors Stop-CsWindowsService arrête le service spécifié sur l’ordinateur distant. L’ordinateur distant doit être référencé à l’aide de son nom de domaine complet. Exemple : atl-mcs-001.litwareinc.com. |
Graceful |
Facultatif |
Paramètre de commutateur |
Plutôt que de mettre immédiatement fin au service, attend que les demandes de services aient été satisfaites. (Toutes les nouvelles demandes de service seront toutefois rejetées.) Le service ne sera pas complètement interrompu tant que les demandes existantes n’auront pas été satisfaites. |
InputObject |
Facultatif |
Objet NTService |
Vous permet d’interrompre un service à l’aide de la référence d’objet plutôt que le nom de service. Par exemple, si vous utilisez Get-CsWindowsService pour retourner les informations concernant un service et que vous enregistrez l’objet retourné dans une variable nommée $x, vous pouvez arrêter le service en utilisant la commande suivante : $x = Get-CsWindowsService –Name "RTCCPS" Stop-CsWindowsService -InputObject $x.Name |
NoWait |
Facultatif |
Paramètre de commutateur |
S’il existe, ce paramètre force l’exécution de la commande et passe immédiatement les commandes à l’invite de Windows PowerShell. Dans le cas contraire, la commande ne sera pas passée tant qu’elle n’est pas terminée et que le rapport d’état n’a pas été affiché à l’écran. |
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 |
Le chemin d’un fichier HTML où les informations d’erreur peuvent être écrites. 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). |
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
Objet Microsoft.Rtc.Management.Deployment.Core.NTService. Stop-CsWindowsService accepte les instances transmises via le pipeline de l’objet Service Windows.
Types de retours
Aucun. Stop-CsWindowsService interrompt les instances de l’objet Microsoft.Rtc.Management.Deployment.Core.NTService.
Exemple
-------------------------- Exemple 1 --------------------------
Stop-CsWindowsService -Name "RTCRGS"
La commande illustrée à l’exemple 1 interrompt le service application Response Group sur l’ordinateur local. On identifie le service application Response Group en incluant le paramètre Name et le nom de ce service : RTCRGS.
-------------------------- Exemple 2 --------------------------
Stop-CsWindowsService -Name "RTCRGS" -ComputerName atl-cs-001.litwareinc.com
L’exemple 2 interrompt également le service application Response Group. Dans cet exemple cependant, l’emplacement du service est l’ordinateur distant atl-cs-001.litwareinc.com. Pour arrêter un service sur l’ordinateur distant, insérez le paramètre ComputerName suivi du nom de domaine complet de l’ordinateur distant.
-------------------------- Exemple 3 --------------------------
Get-CsWindowsService | Where-Object {$_.DisplayName -like "*Call Park*"} | Stop-CsWindowsService
L’exemple 3 démontre comment interrompre un service même si vous ne connaissez pas le nom de service (dans cet exemple, RTCCPS). Pour ce faire, la commande appelle d’abord Get-CsWindowsService (sans aucun paramètre) afin de retourner une collection de tous les services Lync Server sur l’ordinateur distant. Cette collection complète est ensuite acheminée vers la cmdlet Where-Object qui sélectionne uniquement les services pour lesquels la propriété DisplayName inclut la valeur de chaîne « Call Park ». La collection filtrée est ensuite acheminée vers Stop-CsWindowsService qui interrompt le service application de parcage d’appel.