Start-CsWindowsService
Ultima modifica dell'argomento: 2012-03-27
Start-CsWindowsService consente di avviare un servizio Microsoft Lync Server 2010.
Sintassi
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>]]
Descrizione dettagliata
Molti componenti di Lync Server 2010 vengono eseguiti come servizi Windows standard, ad esempio il componente applicazione Operatore Conferenza è in realtà un componente denominato RTCCAA. Se uno dei servizi di Lync Server è attualmente arrestato, è possibile riavviare il servizio con il cmdlet Start-CsWindowsService.
Occorre ricordare che Start-CsWindowsService consente di avviare solo i servizi di Lync Server; si verificherà un errore se si tenta di avviare un servizio non appartenente a Lync Server (ad esempio lo spooler di stampa) utilizzando questo cmdlet.
A livello funzionale, Start-CsWindowsService è molto simile al cmdlet generico di Windows PowerShellStart-Service; se si desidera, è possibile utilizzare Start-Service per avviare un servizio di Lync Server. Tuttavia, Start-CsWindowsService include un parametro ComputerName che facilita l'avvio di un servizio su un computer remoto: è sufficiente includere il parametro ComputerName seguito dal nome di dominio completo del computer remoto. Stop-Service non dispone di un parametro di questo tipo. Inoltre, il parametro Report del cmdlet consente di mantenere un registro degli errori che possono verificarsi durante la chiamata a Start-CsWindowsService.
Come altri servizi Windows, alcuni servizi di Lync Server dipendono da altri servizi; ad esempio, il servizio Operatore Conferenza di Lync Server non può essere eseguito se Servizio applicazione non è già in esecuzione. Se si tenta di avviare un servizio che dipende da un altro servizio, Start-CsWindowsService consente di avviare entrambi i servizi. Ad esempio, se si tenta di avviare il servizio Operatore Conferenza, il cmdlet avvia per prima cosa il Servizio applicazione e quindi avvia il servizio Operatore Conferenza. Tuttavia, Start-CsWindowsService non consente di avviare automaticamente eventuali servizi dipendenti di un servizio: se si avvia il Servizio applicazione, il comando non avvia automaticamente anche il servizio Operatore Conferenza.
Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Start-CsWindows in locale: RTCUniversalServerAdmins. Inoltre, per eseguire questo cmdlet è necessario disporre dei diritti di amministratore locale sul computer di destinazione. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Start-CsWindowsService"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Name |
Facoltativo |
Stringa |
Nome del servizio Lync Server da avviare. Si noti che si deve utilizzare il nome del servizio (ad esempio RTCCAA) e non il nome visualizzato del servizio. È possibile passare un singolo nome di servizio al parametro Name e non è consentito l'uso di caratteri jolly nel nome del servizio. I nomi dei servizi possono essere recuperati mediante il cmdlet Get-CsWindowsService. Occorre ricordare che Start-CsWindowsService consente di avviare solo i servizi di Lync Server; non può essere utilizzato per avviare altri servizi Windows. Per questi servizi è possibile utilizzare il cmdlet Start-Service di Windows PowerShell. |
ComputerName |
Facoltativo |
Stringa |
Nome del computer remoto che ospita il servizio da avviare; se questo parametro non è incluso, Start-CsWindowsService consente di avviare il servizio specificato (o i servizi specificati) sul computer locale. Al computer remoto si deve fare riferimento utilizzando il suo nome di dominio completo, ad esempio, atl-cs-001.litwareinc.com. |
InputObject |
Facoltativo |
Oggetto NTService |
Consente di avviare un servizio utilizzando un riferimento oggetto anziché un nome di servizio. Ad esempio, se si utilizza Get-CsWindowsService per restituire informazioni su un servizio e si archivia l'oggetto restituito in una variabile denominata $x, è possibile avviare il servizio utilizzando questo comando: $x = Get-CsWindowsService -Name "RTCCPS" Start-CsWindowsService -InputObject $x.Name |
NoWait |
Facoltativo |
Parametro opzionale |
Se presente, fa sì che il comando venga eseguito e restituisca immediatamente il controllo al prompt di Windows PowerShell. Se non è presente, il controllo non viene restituito fin quando il comando non è stato completato e sullo schermo non è stata scritta una relazione sullo stato. |
Force |
Facoltativo |
Parametro opzionale |
Consente di ignorare la visualizzazione di messaggi di errore non irreversibili che possono verificarsi durante l'esecuzione del comando. |
Report |
Facoltativo |
Stringa |
Percorso di un file HTML in cui è possibile archiviare le informazioni sugli errori. Se viene incluso questo parametro, qualunque errore durante l'esecuzione di questo cmdlet verrà registrato nel file specificato (ad esempio, C:\Logs\Service_report.html). |
WhatIf |
Facoltativo |
Parametro opzionale |
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente. |
Confirm |
Facoltativo |
Parametro opzionale |
Viene visualizzata una richiesta di conferma prima di eseguire il comando. |
Tipi di input
Oggetto Microsoft.Rtc.Management.Deployment.Core.NTService. Start-CsWindowsService consente di accettare le istanze da pipeline dell'oggetto servizio Windows.
Tipi restituiti
Nessuno. Start-CsWindowsService consente invece di avviare le istanze dell'oggetto Microsoft.Rtc.Management.Deployment.Core.NTService.
Esempio
-------------------------- Esempio 1 --------------------------
Start-CsWindowsService
Con il comando mostrato nell'esempio 1 vengono avviati tutti i servizi di Lync Server sul computer locale. Questa operazione viene eseguita chiamando Start-CsWindowsService senza alcun parametro. Non viene visualizzato alcun errore se si tenta di avviare un servizio che è già stato avviato.
-------------------------- Esempio 2 --------------------------
Start-CsWindowsService -Name "RTCRGS"
Con il comando precedente viene avviato il servizio applicazione Response Group sul computer locale. A tal fine, il comando utilizza il parametro Name seguito dal nome del servizio: RTCRGS.
-------------------------- Esempio 3 --------------------------
Start-CsWindowsService -Name "RTCRGS" -ComputerName atl-cs-001.litwareinc.com
Anche con il comando mostrato nell'esempio 3 viene avviato il servizio applicazione Response Group; in questo caso, però, il servizio viene avviato sul computer remoto atl-cs-001.litwareinc.com. Per avviare un servizio su un computer remoto, è sufficiente includere il parametro ComputerName seguito dal nome di dominio completo del computer remoto.
-------------------------- Esempio 4 --------------------------
Get-CsWindowsService | Where-Object {$_.Status -ne "Running"} | Start-CsWindowsService
Con l'esempio 4 il comando ricerca sul computer locale tutti i servizi di Lync Server che attualmente non sono in esecuzione, quindi avvia ogni servizio inattivo. Per eseguire questa operazione, il comando chiama per prima cosa Get-CsWindowsService per restituire una raccolta di tutti i servizi di Lync Server. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo i servizi in cui la proprietà Status non equivale a Running. Tale raccolta filtrata viene quindi inviata tramite pipe a Start-CsWindowsService, che avvia ciascun servizio nella raccolta.