Get-CsWindowsService
Ultima modifica dell'argomento: 2012-03-23
Get-CsWindowsService restituisce informazioni dettagliate sui componenti di Microsoft Lync Server 2010 che vengono eseguiti come servizi Windows.
Sintassi
Get-CsWindowsService [-Name <String>] [-ComputerName <String>] [-ExcludeActivityLevel <SwitchParameter>] [-Report <String>]
Descrizione dettagliata
Molti componenti di Lync Server 2010 vengono eseguiti come servizi Windows standard, ad esempio il componente Lync Server applicazione Operatore Conferenza è in realtà un componente denominato RTCCAA. Il cmdlet Get-CsWindowsService consente di recuperare informazioni dettagliate relative a questi servizi Lync Server e solo questi servizi. Questo poiché il cmdlet è stato progettato per ignorare qualunque servizio che non sia parte di Lync Server.
Il fatto che Get-CsWindowsService escluda automaticamente i servizi non-Lync Server è un vantaggio che questo cmdlet offre rispetto al generico cmdlet Get-Service distribuito come parte di Windows PowerShell. Inoltre, esiste un'altra importante ragione per utilizzare Get-CsWindowsService quando è necessario recuperare informazioni sui servizi di Lync Server: Get-CsWindowsService restituisce dati utili che non vengono restituiti da Get-Service. Ad esempio, nelle informazioni relative al servizio Conferencing Attendant di Lync Server, Get-CsWindowsService riporta il numero di chiamate simultanee gestite dal servizio (il livello di attività del servizio). Get-Service non lo fa.
Per impostazione predefinita Get-CsWindowsService viene eseguito rispetto al computer locale. Tuttavia, includendo il parametro ComputerName è possibile ottenere informazioni relative a servizi di Lync Server in esecuzione su un computer remoto.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Get-CsWindowsService può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalServerAdmins. Inoltre, per eseguire questo cmdlet è necessario essere membri del gruppo Performance Monitor Users sul computer di destinazione. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsWindowsService"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Name |
Facoltativo |
Stringa |
Nome del servizio del quale si cercano informazioni. Si noti che è necessario utilizzare il nome del servizio (ad esempio, RTCCAA) e non il nome visualizzato del servizio. Al parametro Name è possibile fornire un solo nome di servizio, inoltre nel nome del servizio non sono ammessi caratteri jolly. Si noti ancora che Get-CsWindowsService può restituire informazioni solo per servizi di Lync Server non è possibile utilizzare questo cmdlet per ottenere informazioni su altri servizi Windows. Per quei servizi si deve essere in grado di utilizzare il cmdlet Windows PowerShell Get-Service. Se non si include questo parametro Get-CsWindowsService restituirà informazioni su tutti i servizi di Lync Server. |
ComputerName |
Facoltativo |
Stringa |
Nome del computer remoto dal quale recuperare le informazioni relative ai servizi; se questo parametro non viene incluso allora Get-CsWindowsService restituirà informazioni relative ai servizi di Lync Server in esecuzione sul computer locale. Al computer remoto si deve fare riferimento utilizzando il suo nome completo di dominio (FQDN); ad esempio, atl-mcs-001.litwareinc.com. |
ExcludeActivityLevel |
Facoltativo |
Parametro opzionale |
Se viene incluso questo parametro, Get-CsWindowsService restituisce solo lo stato del servizio e non il livello di attività del servizio. |
Report |
Facoltativo |
Stringa |
Percorso per un file HTML dove possono essere memorizzate le informazioni relative agli 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). |
Tipi di input
Nessuno. Get-CsWindowsService non accetta input tramite pipeline.
Tipi restituiti
Get-CsWindowsService restituisce le istanze dell'oggetto Microsoft.Rtc.Management.Deployment.Core.NTService.
Esempio
-------------------------- Esempio 1 ------------------------
Get-CsWindowsService
Il comando riportato nell'Esempio 1 restituisce informazioni relative ai servizi di Lync Server in esecuzione sul computer locale. Per ottenere questo risultato, viene utilizzato il cmdlet Get-CsWindowsService senza alcun parametro.
-------------------------- Esempio 2 ------------------------
Get-CsWindowsService | Format-List
L'Esempio 2 restituisce informazioni relative a servizi di Lync Server in esecuzione sul computer locale, tuttavia in questo caso i dati vengono visualizzati in formato elenco. Fra l'altro, consente di visualizzare il valore di tutte le proprietà di ciascun servizio. Nella visualizzazione predefinita, vista tabellare, viene visualizzato solo un subset dei valori delle proprietà. Per ottenere questo risultato, viene utilizzato prima il cmdlet Get-CsWindowsService e quindi le informazioni risultanti vengono inviate tramite pipe al cmdlet Format-List.
-------------------------- Esempio 3 ------------------------
Get-CsWindowsService -Name "RTCSrv"
Con l'esempio 3 vengono restituite le informazioni per un singolo servizio di Lync Server: il servizio denominato RTCSrv.
-------------------------- Esempio 4 ------------------------
Get-CsWindowsService -Name "RTCSrv" | Select-Object -ExpandProperty RoleName
Nell'Esempio 4, vengono visualizzate informazioni dettagliate per tutti i ruoli di servizio gestiti dal servizio RTCSrv. Per ottenere questo risultato, viene utilizzato Get-CsWindowsService per recuperare informazioni relative al servizio RTCSrv. Queste informazioni vengono quindi inviate tramite pipe al cmdlet Select-Object che utilizza il parametro ExpandProperty per visualizzare tutti i ruoli gestiti dal servizio RTCSrv. Si noti che questo comando restituisce un messaggio di errore se un servizio non possiede un nome di ruolo.
-------------------------- Esempio 5 ------------------------
Get-CsWindowsService -Computer atl-cs-001.litwareinc.com
Il comando riportato nell'Esempio 5 restituisce informazioni relative ai servizi di Lync Server sul computer remoto atl-cs-001.litwareinc.com. Per ottenere questo risultato, viene incluso il parametro -ComputerName seguito dal nome completo di dominio (FQDN) del computer remoto.
-------------------------- Esempio 6 ------------------------
Get-CsWindowsService -Report C:\Logs\Services.html
Il comando precedente restituisce informazioni relative a tutti i servizi di Lync Server sul computer locale. In aggiunta, il parametro Report viene incluso per salvare le informazioni di errore in un file denominato C:\Services.html. Se Get-CsWindowsService rileva qualunque problema nel recuperare i dati del servizio, le informazioni relative a quel problema verranno registrate in Services.html.
-------------------------- Esempio 7 ------------------------
Get-CsWindowsService | Where-Object {$_.Status -eq "Running"}
Nell'esempio 7, le informazioni vengono restituite solo per i servizi di Lync Server correntemente in esecuzione sul computer locale. Per ottenere questo risultato, il comando utilizza Get-CsWindowsService per ottenere una raccolta di tutti i servizi di Lync Server indipendentemente dal fatto che siano o meno in esecuzione. La raccolta così ottenuta viene quindi inviata tramite pipe al cmdlet Where-Object che seleziona solo quelle impostazioni in cui la proprietà Status è uguale a Running.
-------------------------- Esempio 8 ------------------------
Get-CsWindowsService | Where-Object {$_.DisplayName -like "*Application Sharing*"}
L'Esempio 8 mostra come recuperare informazioni relative ad un particolare servizio anche senza sapere il nome reale di quel servizio (in questo caso, RTCASMCU). Per ottenere questo risultato, viene utilizzato Get-CsWindowsService senza alcun parametro in modo da ottenere una raccolta di tutti i servizi di Lync Server sul computer locale. Questa raccolta viene inviata tramite pipe al cmdlet Where-Object che seleziona solo quel servizio in cui la proprietà DisplayName include il valore "Application Sharing". Risultato finale: le informazioni vengono visualizzate per Lync Server servizio conferenze di Condivisione applicazioni.
-------------------------- Esempio 9 ------------------------
Get-CsWindowsService | Where-Object {$_.RoleName -contains "ApplicationServer"}
L'Esempio 9 restituisce informazioni relative al servizio che ospita il ruolo ApplicationServer. Per ottenere questo risultato, il comando utilizza Get-CsWindowsService per ottenere una raccolta di tutti i servizi di Lync Server sul computer locale. Questa raccolta viene inviata tramite pipe al cmdlet Where-Object che seleziona quei servizi in cui la proprietà RoleName include (-contains) il ruolo ApplicationServer.