Get-CsService

Sintassi

Get-CsService [-Identity <XdsGlobalRelativeIdentity>] [-PoolFqdn <String>]

Get-CsService [-ApplicationServer <SwitchParameter>] [-PoolFqdn <String>]

Get-CsService [-ApplicationDatabase <SwitchParameter>] [-PoolFqdn <String>]

Get-CsService [-ArchivingServer <SwitchParameter>] [-PoolFqdn <String>]

Get-CsService [-ArchivingDatabase <SwitchParameter>] [-PoolFqdn <String>]

Get-CsService [-CentralManagement <SwitchParameter>] [-PoolFqdn <String>]

Get-CsService [-CentralManagementDatabase <SwitchParameter>] [-PoolFqdn <String>]

Get-CsService [-ConferencingServer <SwitchParameter>] [-PoolFqdn <String>]

Get-CsService [-Director <SwitchParameter>] [-PoolFqdn <String>]

Get-CsService [-EdgeServer <SwitchParameter>] [-PoolFqdn <String>]

Get-CsService [-PoolFqdn <String>] [-TrustedApplicationPool <SwitchParameter>]

Get-CsService [-FileStore <SwitchParameter>] [-PoolFqdn <String>]

Get-CsService [-ManagementServer <SwitchParameter>] [-PoolFqdn <String>]

Get-CsService [-MediationServer <SwitchParameter>] [-PoolFqdn <String>]

Get-CsService [-MonitoringServer <SwitchParameter>] [-PoolFqdn <String>]

Get-CsService [-MonitoringDatabase <SwitchParameter>] [-PoolFqdn <String>]

Get-CsService [-PoolFqdn <String>] [-PstnGateway <SwitchParameter>]

Get-CsService [-PoolFqdn <String>] [-ProvisionServer <SwitchParameter>]

Get-CsService [-PoolFqdn <String>] [-ProvisionDatabase <SwitchParameter>]

Get-CsService [-PoolFqdn <String>] [-Registrar <SwitchParameter>]

Get-CsService [-PoolFqdn <String>] [-UserServer <SwitchParameter>]

Get-CsService [-PoolFqdn <String>] [-UserDatabase <SwitchParameter>]

Get-CsService [-PoolFqdn <String>] [-WebServer <SwitchParameter>]

Get-CsService [-Filter <String>] [-PoolFqdn <String>]

Descrizione dettagliata

Le funzionalità disponibili in Lync Server 2010 vengono definite in genere come servizi o ruoli del server. Ad esempio, è possibile configurare Lync Server in modo da salvare automaticamente la trascrizione di ciascuna sessione di messaggistica istantanea che avviene nell'organizzazione. A tale scopo, è necessario installare il ruolo del server Server di archiviazione. I servizi e i ruoli del server possono essere configurati contemporaneamente all'installazione di Lync Server o possono essere configurati con il software in esecuzione.

Il ruolo Get-CsService consente di restituire informazioni sui ruoli del server e sui servizi in esecuzione nell'organizzazione. Get-CsService, chiamato senza parametri aggiuntivi, restituisce informazioni dettagliate su tutti i servizi e i ruoli del server in uso. In alternativa, è possibile limitare i dati restituiti ad un pool specifico utilizzando il parametro PoolFqdn. È possibile inoltre utilizzare un numero qualsiasi di parametri opzionali per limitare i dati restituiti ad un tipo specifico di servizio. Un parametro opzionale è un parametro che non richiede un valore del parametro. Ad esempio, questo comando restituisce informazioni su tutti i server di archiviazione in uso:

Get-CsService –ArchivingServer

È possibile utilizzare solamente un parametro opzionale di questo tipo per ciascun comando. Il comando seguente, che tenta di restituire le informazioni sia sui server di archiviazione sia sui server di monitoraggio, non funzionerà:

Get-CsService –ArchivingServer –MonitoringServer

Per restituire le informazioni per più ruoli del server, è possibile utilizzare Get-CsService in modo da restituire la raccolta completa dei dati del servizio ed inviare tali dati tramite pipe al cmdlet Where-Object:

Get-CsService | Where-Object {$_.Role –eq "ArchivingServer" –or $_.Role –eq "MonitoringServer"}

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi seguenti sono autorizzati a eseguire il cmdlet Get-CsService in locale: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli del controllo di accesso basato sui ruoli (RBAC) ai quali è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati creati dall'utente), eseguire il comando seguente dal prompt di Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsService"}

Parametri

Tipi di input

Nessuno. Get-CsService non accetta input inviato tramite pipe.

Tipi restituiti

Get-CsService restituisce oggetti diversi sulla base dei parametri utilizzati durante la chiamata del cmdlet. Ad esempio, se si include il parametro MonitoringDatabase, Get-CsService restituisce le istanze dell'oggetto Microsoft.Rtc.Management.Xds.DisplayMonitoringDatabase. Per determinare gli oggetti restituiti utilizzando altri parametri, effettuare la chiamata di Get-CsService utilizzando uno di questi parametri ed inviare quindi tramite pipe l'oggetto restituito al cmdlet Get-Member. Ad esempio: Get-CsService -Registrar | Get-Member.

Esempio

-------------------------- Esempio 1 ------------------------

Get-CsService

Il comando indicato nell'esempio 1 restituisce informazioni su tutti i servizi e i ruoli del server di Lync Server 2010 attualmente in esecuzione nell'organizzazione.

-------------------------- Esempio 2 ------------------------

Get-CsService -ApplicationServer

Nell'esempio 2 vengono restituite informazioni su Servizio applicazione. È possibile restituire le informazioni per altri servizi/ruoli del server semplicemente utilizzando il parametro appropriato. Ad esempio, questo comando restituisce le informazioni sull'archivio file:

Get-CsService -FileStore

-------------------------- Esempio 3 ------------------------

Get-CsService -PoolFqdn "atl-cs-001.litwareinc.com" | Select-Object Identity

Il comando precedente restituisce il parametro Identity per ciascun servizio presente nel pool atl-cs-001.litwareinc.com. Per eseguire questa operazione, il comando effettua per prima cosa la chiamata di Get-CsService e del parametro PoolFqdn per restituire solo i servizi e i ruoli del server presenti nel pool atl-cs-001.litwareinc.com. La raccolta viene quindi inviata tramite pipe al cmdlet Select-Object, che restituisce il parametro Identity di ogni elemento nella raccolta.

-------------------------- Esempio 4 ------------------------

Get-CsService | Where-Object {$_.SiteID -eq "site:Redmond"}

Nell'esempio 4 le informazioni vengono restituite per tutti i servizi/ruoli del server trovati nel sito di Redmond. Questo si esegue effettuando per prima cosa la chiamata di Get-CsService senza alcun parametro, per restituire la raccolta di tutti i servizi e ruoli del server attualmente in uso nell'organizzazione. I dati vengono quindi inviati tramite pipe al cmdlet Where-Object, che estrae solo quegli elementi in cui la proprietà SiteID è uguale a site:Redmond.

-------------------------- Esempio 5 ------------------------

Get-CsService | Where-Object {$_.DependentServiceList -like "*Registrar*"}

Il comando indicato nell'esempio 5 restituisce le informazioni su tutti i servizi che definiscono Registrar come un servizio dipendente. A tale scopo, Get-CsService viene chiamato per restituire la raccolta di tutti i servizi e ruoli del server attualmente in uso. La raccolta viene quindi inviata tramite pipe a Where-Object, che seleziona ogni elemento in cui la proprietà DependentServiceList include il valore stringa "Registrar". I criteri Where-Object vengono specificati utilizzando l'operatore -like ed il carattere jolly "*Registrar*".

Vedere anche

Ulteriori risorse

Set-CsApplicationServer
Set-CsArchivingServer
Set-CsConferenceServer
Set-CsDirector
Set-CsEdgeServer
Set-CsManagementServer
Set-CsMediationServer
Set-CsMonitoringServer
Set-CsRegistrar
Set-CsUserServer
Set-CsWebServer