Get-CsService
Ultima modifica dell'argomento: 2012-03-23
Restituisce informazioni sui servizi e sui ruoli del server utilizzati nell'infrastruttura di Microsoft Lync Server 2010. Un servizio è un'istanza di un ruolo che è stata distribuita in un pool di Lync Server 2010. Ad esempio, è possibile si potrebbe avere un pool di computer che eseguono il servizio Monitoring Server.
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
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
Identità XDS |
L'identificatore univoco del servizio o del ruolo del server specifico da restituire. Ad esempio: -Identity "Registrar:atl-cs-001.litwareinc.com". |
Filter |
Facoltativo |
Stringa |
Consente di utilizzare i caratteri jolly per specificare il servizio (o i servizi) da restituire. Non è possibile utilizzare i parametri Filter e Identity nello stesso comando. |
ApplicationDatabase |
Facoltativo |
Parametro opzionale |
Restituisce informazioni sui database dell'applicazione utilizzati nell'organizzazione. I database dell'applicazione vengono utilizzati da Servizio applicazione. |
ApplicationServer |
Facoltativo |
Parametro opzionale |
Restituisce informazioni su Servizio applicazione. Servizio applicazione consente di eseguire le applicazioni create utilizzando Microsoft Unified Communications Managed API (UCMA). |
ArchivingDatabase |
Facoltativo |
Parametro opzionale |
Restituisce informazioni sui database di archiviazione utilizzati nell'organizzazione. I database di archiviazione archiviano le trascrizioni delle sessioni di messaggistica istantanea. |
ArchivingServer |
Facoltativo |
Parametro opzionale |
Restituisce informazioni sui server di archiviazione utilizzati nell'organizzazione. I server di archiviazione consentono di salvare le trascrizioni delle sessioni di messaggistica istantanea. |
CentralManagement |
Facoltativo |
Parametro opzionale |
Restituisce informazioni sul servizio servizio di gestione centrale utilizzato nell'organizzazione. Il servizio servizio di gestione centrale viene utilizzato per inviare i dati di configurazione ai computer che eseguono servizi di Lync Server 2010. |
CentralManagementDatabase |
Facoltativo |
Parametro opzionale |
Restituisce informazioni sul archivio di gestione centrale utilizzato nell'organizzazione. Il archivio di gestione centrale mantiene le informazioni di configurazione per Lync Server. |
ConferencingServer |
Facoltativo |
Parametro opzionale |
Restituisce informazioni sul servizio servizio A/V Conferencing utilizzato nell'organizzazione. servizio A/V Conferencing è utilizzato per gestire le riunioni e le conferenze in linea. |
Director |
Facoltativo |
Parametro opzionale |
Restituisce informazioni sui Director utilizzati nell'organizzazione. I Director sono configurati per gestire le richieste degli utenti e l'autenticazione utente, ma non per ospitare gli account utente. In genere i Director vengono utilizzati per gestire le richieste degli utenti esterni. |
EdgeServer |
Facoltativo |
Parametro opzionale |
Restituisce informazioni sui server perimetrali utilizzati nell'organizzazione. I server perimetrali forniscono connettività tra la rete interna ed Internet. |
FileStore |
Facoltativo |
Parametro opzionale |
Restituisce informazioni sugli archivi file utilizzati nell'organizzazione. L'archivio file viene utilizzato per conservare i file di Lync Server, quali i file audio utilizzati dal servizio Annuncio. |
ManagementServer |
Facoltativo |
Parametro opzionale |
Restituisce informazioni sul server di gestione centrale utilizzato nell'organizzazione. server di gestione centrale in genere è collocato nei server front-end ed è responsabile dell'accesso alle informazioni nel archivio di gestione centrale. |
MediationServer |
Facoltativo |
Parametro opzionale |
Restituisce informazioni sui Mediation Server utilizzati nell'organizzazione. I Mediation Server consentono di costituire un ponte tra la rete VoIP aziendale e la rete PSTN (Public Switched Telephone Network). |
MonitoringServer |
Facoltativo |
Parametro opzionale |
Restituisce informazioni sui server di monitoraggio utilizzati nell'organizzazione. I server di monitoraggio vengono utilizzati per tenere traccia dell'utilizzo del telefono e della qualità delle chiamate di VoIP aziendale. |
MonitoringDatabase |
Facoltativo |
Parametro opzionale |
Restituisce informazioni sui database di monitoraggio utilizzati nell'organizzazione. I database di monitoraggio archiviano le informazioni relative all'utilizzo del telefono e alla qualità delle chiamate di VoIP aziendale. |
PoolFqdn |
Facoltativo |
Stringa |
Il nome di dominio completo del pool che ospita il servizio o il ruolo del server. Se si utilizza il parametro PoolFqdn senza specificare un parametro specifico del servizio, verranno restituiti tutti i servizi e i ruoli del server trovati sul pool. |
ProvisionServer |
Facoltativo |
Parametro opzionale |
Restituisce informazioni sul servizio Provision Server utilizzato nell'organizzazione. Tale servizio viene utilizzato per gestire i certificati di Lync Server. |
ProvisionDatabase |
Facoltativo |
Parametro opzionale |
Restituisce informazioni sui database di provisioning utilizzati nell'organizzazione. I database di provisioning mantengono le informazioni sui certificati di Lync Server. |
PstnGateway |
Facoltativo |
Parametro opzionale |
Restituisce informazioni sui gateway PSTN (Public Switched Telephone Network) utilizzati nell'organizzazione. I gateway PSTN convertono i segnali inviati dai dispositivi VoIP aziendale in segnali che possono essere compresi dai dispositivi PSTN e viceversa. |
Registrar |
Facoltativo |
Parametro opzionale |
Restituisce informazioni sui Registrar utilizzati nell'organizzazione. I Registrar vengono utilizzati per autenticare gli utenti e tenere traccia dello stato corrente di un utente. |
TrustedApplicationPool |
Facoltativo |
Parametro opzionale |
Restituisce informazioni sui pool di applicazioni attendibili utilizzati nell'organizzazione. In tali pool sono ospitati i computer che eseguono applicazioni attendibili. |
UserDatabase |
Facoltativo |
Parametro opzionale |
Restituisce informazioni sul database degli utenti utilizzato nell'organizzazione. I database utente archiviano i dati necessari al servizio Server utente. |
UserServer |
Facoltativo |
Parametro opzionale |
Restituisce informazioni sul Servizi utente utilizzato nell'organizzazione. Il servizio Servizi utente consente di eseguire la replica degli utenti, il provisioning di tipo in-band, la pubblicazione e le notifiche di presenza e lo scambio delle schede contatto. |
WebServer |
Facoltativo |
Parametro opzionale |
Restituisce informazioni sul servizi Web utilizzato nell'organizzazione. Il servizio servizi Web ospita applicazioni basate su Web quali il Servizio Rubrica. |
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*".