Stop-CsWindowsService
Ultima modifica dell'argomento: 2012-03-27
Stop-CsWindowsService consente di arrestare un servizio Microsoft Lync Server 2010.
Sintassi
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>]]
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. Per arrestare un servizio di Lync Server è possibile utilizzare il cmdlet Stop-CsWindowsService.
Occorre ricordare che Stop-CsWindowsService consente di arrestare solo i servizi di Lync Server; si verificherà un errore se si tenta di arrestare un servizio non appartenente a Lync Server (ad esempio lo spooler di stampa) utilizzando questo cmdlet.
A livello funzionale, Stop-CsWindowsService è molto simile al cmdlet generico di Windows PowerShellStop-Service; se si desidera, è possibile utilizzare Stop-Service per arrestare un servizio di Lync Server. Tuttavia, Stop-CsWindowsService include un parametro ComputerName che facilita l'arresto di un servizio su un computer remoto: è sufficiente includere il parametro ComputerName seguito dal nome di dominio completo del computer remoto. Il cmdlet Stop-Service non dispone di un parametro di questo tipo. Inoltre, Stop-CsWindowsService dispone di un parametro Report che consente di mantenere un registro degli errori che possono verificarsi durante la chiamata a Stop-CsWindowsService.
Stop-CsWindowsService arresta qualsiasi servizio per cui viene richiesto l'arresto. Sono inclusi i servizi che possono avere servizi dipendenti, cioè servizi che possono essere eseguiti solo se il servizio che si sta tentando di arrestare è in esecuzione. Per impostazione predefinita, se si tenta di arrestare un servizio che presenta dei servizi dipendenti, Stop-CsWindowsService non arresta solo il servizio in questione, ma anche tutti i servizi dipendenti. Dal momento che potrebbero verificarsi conseguenze impreviste, è possibile includere il parametro Graceful nella chiamata a Stop-CsWindowsService. Con l'inclusione del parametro Graceful, Stop-CsWindowsService impedirà al servizio di accettare nuove richieste. Tutte le richieste esistenti per il servizio restano invariate, mentre tutte le nuove richieste vengono rifiutate Al termine delle richieste esistenti, queste non saranno sostituite. Alla fine, tutte le richieste esistenti saranno soddisfatte e il servizio sarà arrestato.
Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Stop-CsWindowsService 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 "Stop-CsWindowsService"}
Parametri
| Parameter | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Name |
Facoltativo |
Stringa |
Nome del servizio Lync Server da arrestare. 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. È possibile utilizzare il cmdlet Get-CsWindowsService per recuperare i nomi dei servizi. Occorre ricordare che Stop-CsWindowsService consente di arrestare solo i servizi di Lync Server; non può essere utilizzato per arrestare altri servizi Windows. Per questi servizi è possibile utilizzare il cmdlet di Stop-Service di Windows PowerShell. |
ComputerName |
Facoltativo |
Stringa |
Nome del computer remoto su cui è in esecuzione il servizio da arrestare; se questo parametro non è incluso, Stop-CsWindowsService consente di arrestare il servizio specificato sul computer locale. Al computer remoto si deve fare riferimento utilizzando il suo nome di dominio completo, ad esempio, atl-mcs-001.litwareinc.com. |
Graceful |
Facoltativo |
Parametro opzionale |
Invece di arrestare immediatamente un servizio, consente di attendere che tutte le richieste esistenti del servizio siano soddisfatte. Le nuove richieste al servizio saranno invece rifiutate. Il servizio non viene completamente arrestato finché non sono state soddisfatte tutte le richieste esistenti. |
InputObject |
Facoltativo |
Oggetto NTService |
Consente di arrestare 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 arrestare il servizio utilizzando questo comando: $x = Get-CsWindowsService –Name "RTCCPS" Stop-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 evitare la visualizzazione di qualunque messaggio di errore non grave che potrebbe essere generato nel corso dell'esecuzione del comando. |
Report |
Facoltativo |
Stringa |
Percorso di un file HTML in cui è possibile scrivere 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. Stop-CsWindowsService consente di accettare le istanze da pipeline dell'oggetto servizio Windows.
Tipi restituiti
Nessuno. Stop-CsWindowsService arresta invece le istanze dell'oggetto Microsoft.Rtc.Management.Deployment.Core.NTService.
Esempio
-------------------------- Esempio 1 --------------------------
Stop-CsWindowsService -Name "RTCRGS"
Con il comando mostrato nell'esempio 1 viene arrestato il servizio applicazione Response Group sul computer locale. Il servizio applicazione Response Group viene identificato includendo il parametro Name e il nome del servizio, RTCRGS.
-------------------------- Esempio 2 --------------------------
Stop-CsWindowsService -Name "RTCRGS" -ComputerName atl-cs-001.litwareinc.com
Anche con l'esempio 2 viene arrestato il servizio applicazione Response Group; in questo esempio, però, il servizio si trova sul computer remoto atl-cs-001.litwareinc.com. Per arrestare un servizio su un computer remoto, è sufficiente includere il parametro ComputerName seguito dal nome di dominio completo del computer remoto.
-------------------------- Esempio 3 --------------------------
Get-CsWindowsService | Where-Object {$_.DisplayName -like "*Call Park*"} | Stop-CsWindowsService
Con l'esempio 3 viene dimostrato come arrestare un servizio anche se non se ne conosce il nome (in questo esempio RTCCPS). Per ottenere tale risultato, il comando chiama Get-CsWindowsService (senza alcun parametro) per restituire una raccolta di tutti i servizi Lync Server sul computer locale. La raccolta completa viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo i servizi la cui proprietà DisplayName contiene il valore stringa "Call Park". La raccolta filtrata viene quindi inviata tramite pipe a Stop-CsWindowsService, che arresta il servizio applicazione Parcheggio di chiamata.