Start-CsWindowsService
Dernière rubrique modifiée : 2012-03-27
Start-CsWindowsService vous permet de démarrer un service Microsoft Lync Server 2010.
Syntaxe
Start-CsWindowsService [-Name <String>] [-ComputerName <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-NoWait <SwitchParameter>] [-Report <String>] [-WhatIf [<SwitchParameter>]]
Start-CsWindowsService [-Confirm [<SwitchParameter>]] [-Force <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 l’un de vos services Lync Server est actuellement interrompu, vous pouvez le redémarrer à l’aide de la cmdlet Start-CsWindowsService.
Toutefois, il est à noter que Start-CsWindowsService ne peut démarrer que des services Lync Server. Une erreur surviendra si vous essayez de démarrer un service autre que Lync Server (comme le spouleur d’impression) à l’aide de cette cmdlet.
D’un point de vue fonctionnel, Start-CsWindowsService est très similaire à la cmdlet Windows PowerShell générique Start-Service. Si vous voulez, vous pouvez aussi utiliser Start-Service pour démarrer un service Lync Server. Par contre, Start-CsWindowsService comprend un paramètre ComputerName qui permet de démarrer 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. Stop-Service n’a pas de paramètre comparable. De plus, le paramètre Report de la cmdlet permet de conserver un journal des erreurs qui pourraient survenir en contactant Start-CsWindowsService.
À l’instar d’autres services Windows, certains services Lync Server sont interdépendants, par exemple le service Intendant Conférence de Lync Server ne peut pas fonctionner si le service d’application fonctionne déjà. Si vous essayez de démarrer un service qui dépend d’un autre, Start-CsWindowsService démarrera les deux services. Cela signifie que si vous essayez de démarrer le service Intendant Conférence, la cmdlet démarrera d’abord le service service d’application et ensuite ce premier service. Néanmoins, Start-CsWindowsService ne démarrera pas automatiquement des services interdépendants : Si vous démarrez le service d’application, ne vous attendez pas à ce que la commande démarre automatiquement le service Intendant Conférence.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Start-CsWindows : 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 "Start-CsWindowsService"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Name |
Facultatif |
Chaîne |
Nom du service Lync Server que vous voulez démarrer. 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. Les noms des services peuvent être récupérés avec la cmdlet Get-CsWindowsService. Gardez à l’esprit que Start-CsWindowsService ne peut démarrer que des services Lync Server. Vous ne pouvez pas utiliser cette cmdlet pour démarrer d’autres services Windows. Pour ces services, vous pouvez utiliser la cmdlet Start-Service de Windows PowerShell. |
ComputerName |
Facultatif |
Chaîne |
Nom de l’ordinateur distant qui héberge le service à démarrer. Si ce paramètre n’est pas inclus, alors le service Start-CsWindowsService démarrera le ou les services spécifiés sur l’ordinateur local. L’ordinateur distant doit être référencé à l’aide de son nom de domaine complet. Exemple : atl-cs-001.litwareinc.com. |
InputObject |
Facultatif |
Objet NTService |
Vous permet de démarrer 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 si vous enregistrez l’objet retourné dans une variable nommée $x, vous pouvez démarrer le service en utilisant la commande suivante : $x = Get-CsWindowsService -Name "RTCCPS" Start-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 vers un fichier HTML où une information d’erreur peut être écrite. 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. Start-CsWindowsService accepte les instances transmises via le pipeline de l’objet Service Windows.
Types de retours
Aucun. Au lieu de cela, Start-CsWindowsService démarre des instances de l’objet Microsoft.Rtc.Management.Deployment.Core.NTService.
Exemple
-------------------------- Exemple 1 --------------------------
Start-CsWindowsService
La commande illustrée à l’exemple 1 démarre tous les services Lync Server sur l’ordinateur local. Cela est possible en appelant Start-CsWindowsService sans paramètre. Notez que vous ne recevrez aucune erreur si vous essayez de démarrer un service qui a déjà démarré.
-------------------------- Exemple 2 --------------------------
Start-CsWindowsService -Name "RTCRGS"
La commande précédente démarre le service application Response Group sur l’ordinateur local. Pour ce faire, la commande utilise le paramètre Name suivi du nom du service : RTCRGS.
-------------------------- Exemple 3 --------------------------
Start-CsWindowsService -Name "RTCRGS" -ComputerName atl-cs-001.litwareinc.com
La commande illustrée à l’exemple 3 démarre également le service application Response Group. Dans ce cas, cependant, le service est lancé sur l’ordinateur distant atl-cs-001.litwareinc.com. Pour démarrer un service sur l’ordinateur distant, insérez le paramètre ComputerName suivi du nom de domaine complet de l’ordinateur distant.
-------------------------- Exemple 4 --------------------------
Get-CsWindowsService | Where-Object {$_.Status -ne "Running"} | Start-CsWindowsService
Dans l’exemple 4, la commande recherche l’ordinateur local pour tous les services Lync Server qui ne sont pas exécutés actuellement, puis démarre chacun de ces services inactifs. Pour ce faire, la commande appelle d’abord Get-CsWindowsService pour retourner une collection de tous les services Lync Server. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui ne sélectionne que les services pour lesquels la propriété Status n’est pas égale à Running. La collection filtrée est ensuite redirigée vers Start-CsWindowsService qui démarre chaque service dans la collection.