Get-CsService
Letztes Änderungsdatum des Themas: 2012-03-23
Gibt Informationen zu den in der Microsoft Lync Server 2010-Infrastruktur verwendeten Diensten und Serverrollen zurück. Ein Dienst ist eine Instanz einer Rolle, die in einem Lync Server 2010-Pool bereitgestellt wurde. Ein Beispiel hierfür ist eine Gruppe von Computern, auf denen der Monitoring Server-Dienst ausgeführt wird.
Syntax
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>]
Detaillierte Beschreibung
Die in Lync Server 2010 vorhandenen Funktionen werden in der Regel als Dienste oder Serverrollen ausgedrückt. Sie können Lync Server beispielsweise so konfigurieren, dass automatisch eine Aufzeichnung jeder in der Organisation stattfindenden Sofortnachrichtensitzung gespeichert wird. Hierzu müssen Sie die Serverrolle "Archivierungsserver" installieren. Dienste und Serverrollen können während oder nach der Installation von Lync Server konfiguriert werden.
Mit dem Cmdlet Get-CsService können Sie Informationen über die Serverrollen und die in der Organisation ausgeführten Dienste zurückgeben. Wenn Get-CsService ohne zusätzliche Parameter aufgerufen wird, gibt die Rolle ausführliche Informationen zu allen Diensten und Serverrollen zurück. Stattdessen können Sie auch die zurückgegebenen Daten mithilfe des Parameters "PoolFqdn" auf einen spezifischen Pool beschränken. Darüber hinaus können Sie die zurückgegebenen Daten mit einer beliebigen Anzahl von Switch-Parametern auf einen spezifischen Diensttyp beschränken. Als Switch-Parameter wird ein Parameter bezeichnet, der keinen Parameterwert erfordert. Der folgende Befehl gibt beispielsweise Informationen zu allen Archivierungsservern zurück:
Get-CsService –ArchivingServer
Beachten Sie, dass pro Befehl nur ein solcher Switch-Parameter verwendet werden kann. Bei folgendem Befehl, der versucht, Informationen sowohl zu den Archivierungs- als auch den Monitoring Servern zurückzugeben, tritt ein Fehler auf:
Get-CsService –ArchivingServer –MonitoringServer
Wenn Sie Informationen zu mehreren Serverrollen zurückgeben möchten, können Sie mit Get-CsService eine vollständige Auflistung von Dienstdaten zurückgeben und diese dann an das Cmdlet Where-Object weiterleiten:
Get-CsService | Where-Object {$_.Role –eq "ArchivingServer" –or $_.Role –eq "MonitoringServer"}
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Get-CsService lokal auszuführen: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein, um eine Liste aller rollenbasierten Zugriffssteuerungsrollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich der benutzerdefinierten rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsService"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
XdsIdentity |
Eindeutige ID des spezifischen Diensts oder der spezifischen Serverrolle, der bzw. die zurückgegeben werden soll. Beispiel: -Identity "Registrar:atl-cs-001.litwareinc.com". |
Filter |
Optional |
Zeichenfolge |
Ermöglicht die Verwendung von Platzhaltern zum Angeben der zurückzugebenden Dienste. Sie können die Parameter "Identity" und "Filter" nicht im gleichen Befehl verwenden. |
ApplicationDatabase |
Optional |
Switch-Parameter |
Gibt Informationen zu den in Ihrer Organisation verwendeten Anwendungsdatenbanken zurück. Anwendungsdatenbanken werden vom Anwendungsdienst verwendet. |
ApplicationServer |
Optional |
Switch-Parameter |
Gibt Informationen zum Anwendungsdienst zurück. Der Anwendungsdienst bietet eine Möglichkeit zum Ausführen von Anwendungen, die mit Microsoft Unified Communications Managed-API (UCMA) erstellt wurden. |
ArchivingDatabase |
Optional |
Switch-Parameter |
Gibt Informationen zu den in Ihrer Organisation verwendeten Archivierungsdatenbanken zurück. Archivierungsdatenbanken speichern Aufzeichnungen von Instant Messaging-Sitzungen. |
ArchivingServer |
Optional |
Switch-Parameter |
Gibt Informationen zu den in Ihrer Organisation verwendeten Archivierungsservern zurück. Archivierungsserver ermöglichen das Speichern von Aufzeichnungen von Instant Messaging-Sitzungen. |
CentralManagement |
Optional |
Switch-Parameter |
Gibt Informationen zu dem in Ihrer Organisation verwendeten Dienst für die zentrale Verwaltungsdatenbank zurück. Der Dienst für die zentrale Verwaltungsdatenbank sendet Konfigurationsdaten an Computer, auf denen Lync Server 2010-Dienste ausgeführt werden. |
CentralManagementDatabase |
Optional |
Switch-Parameter |
Gibt Informationen zu dem in Ihrer Organisation verwendeten zentraler Verwaltungsspeicher zurück. Mit dem zentraler Verwaltungsspeicher werden Konfigurationsinformationen für Lync Server verwaltet. |
ConferencingServer |
Optional |
Switch-Parameter |
Gibt Informationen zu dem in Ihrer Organisation verwendeten A/V-Konferenzdienst zurück. Der A/V-Konferenzdienst dient zum Abhalten von Besprechungen und Konferenzen. |
Director |
Optional |
Switch-Parameter |
Gibt Informationen zu den in Ihrer Organisation verwendeten Directors zurück. Directors können Benutzeranfragen und Benutzerauthentifizierung verarbeiten, speichern aber keine Benutzerkonten. Sie dienen in der Regel zum Verarbeiten der Anfragen externer Benutzer. |
EdgeServer |
Optional |
Switch-Parameter |
Gibt Informationen zu den in Ihrer Organisation verwendeten Edgeservern zurück. Edgeserver stellen die Verbindung zwischen Ihrem internen Netzwerk und dem Internet her. |
FileStore |
Optional |
Switch-Parameter |
Gibt Informationen zu den in Ihrer Organisation verwendeten Dateispeichern zurück. Der Dateispeicher dient zur Verwaltung von Lync Server-Dateien wie etwa die vom Ankündigungsdienst verwendeten Audiodateien. |
ManagementServer |
Optional |
Switch-Parameter |
Gibt Informationen zu dem in Ihrer Organisation verwendeten zentraler Verwaltungsserver zurück. Im Allgemeinen können Sie den zentraler Verwaltungsserver, der für den Zugriff auf Informationen im zentraler Verwaltungsspeicher verantwortlich ist, mit Front-End-Servern zusammenstellen. |
MediationServer |
Optional |
Switch-Parameter |
Gibt Informationen zu den in Ihrer Organisation verwendeten Vermittlungsservern zurück. Vermittlungsserver bieten eine Brücke zwischen dem Enterprise-VoIP-Netzwerk und dem Telefonfestnetz (Public Switched Telephone Network, PSTN). |
MonitoringServer |
Optional |
Switch-Parameter |
Gibt Informationen zu den in Ihrer Organisation verwendeten Monitoring Servern zurück. Monitoring Server verfolgen die Enterprise-VoIP-Telefonverwendung und -Anrufqualität. |
MonitoringDatabase |
Optional |
Switch-Parameter |
Gibt Informationen zu den in Ihrer Organisation verwendeten Überwachungsdatenbanken zurück. Überwachungsdatenbanken speichern Informationen zur Enterprise-VoIP-Telefonverwendung und -Anrufqualität. |
PoolFqdn |
Optional |
Zeichenfolge |
Vollqualifizierter Domänenname (FQDN) des Pools, der den Dienst oder die Serverrolle hostet. Wenn Sie den Parameter "PoolFqdn" ohne einen dienstspezifischen Parameter verwenden, werden alle in diesem Pool gefundenen Dienste und Serverrollen zurückgegeben. |
ProvisionServer |
Optional |
Switch-Parameter |
Gibt Informationen zu dem in Ihrer Organisation verwendeten Bereitstellungsserverdienst zurück. Der Bereitstellungsserverdienst wird für die Verwaltung von Lync Server-Zertifikaten verwendet. |
ProvisionDatabase |
Optional |
Switch-Parameter |
Gibt Informationen zu den in Ihrer Organisation verwendeten Bereitstellungsdatenbanken zurück. In Bereitstellungsdatenbanken sind Informationen zu Lync Server-Zertifikaten gespeichert. |
PstnGateway |
Optional |
Switch-Parameter |
Gibt Informationen über die in Ihrer Organisation verwendeten Telefonfestnetz-Gateways (Public Switched Telephone Network, PSTN) zurück. PSTN-Gateways übersetzen Signale von Enterprise-VoIP-Geräten in Signale, die von PSTN-Geräten verstanden werden, und umgekehrt. |
Registrar |
Optional |
Switch-Parameter |
Gibt Informationen zu den in Ihrer Organisation verwendeten Registrierungen zurück. Registrierungen dienen zum Authentifizieren von Benutzern und Verfolgen des aktuellen Status eines Benutzers. |
TrustedApplicationPool |
Optional |
Switch-Parameter |
Gibt Informationen zu den in Ihrer Organisation verwendeten vertrauenswürdigen Anwendungspools zurück. Vertrauenswürdige Anwendungspools hosten Computer, die vertrauenswürdige Anwendungen ausführen. |
UserDatabase |
Optional |
Switch-Parameter |
Gibt Informationen zu der in Ihrer Organisation verwendeten Benutzerdatenbank zurück. In der Benutzerdatenbank sind die vom Benutzerserverdienst benötigten Daten gespeichert. |
UserServer |
Optional |
Switch-Parameter |
Gibt Informationen zu den in Ihrer Organisation verwendeten Benutzerdiensten zurück. Die Benutzerdienste bieten unter anderem Benutzerreplikation, In-Band-Bereitstellung, Anwesenheitsveröffentlichung und -benachrichtigung und Visitenkartenaustausch. |
WebServer |
Optional |
Switch-Parameter |
Gibt Informationen zu den in Ihrer Organisation verwendeten Webdiensten zurück. Die Webdienste hosten webbasierte Anwendungen wie z. B. den Adressbuchdienst. |
Eingabetypen
Keine. Get-CsService akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit Get-CsService werden je nach den beim Aufrufen des Cmdlets verwendeten Parametern unterschiedliche Objekte zurückgegeben. Wenn Sie beispielsweise den Parameter "MonitoringDatabase" verwenden, werden mit Get-CsService Instanzen des Objekts "Microsoft.Rtc.Management.Xds.DisplayMonitoringDatabase" zurückgegeben. Um zu ermitteln, welche Objekte mit anderen Parametern zurückgegeben werden, rufen Sie Get-CsService unter Verwendung dieser Parameter auf, und leiten Sie das zurückgegebene Objekt dann an das Cmdlet Get-Member weiter. Beispiel: Get-CsService -Registrar | Get-Member.
Beispiel
-------------------------- Beispiel 1 --------------------------
Get-CsService
Der Befehl in Beispiel 1 gibt Informationen zu allen derzeit in Ihrer Organisation ausgeführten Lync Server 2010-Diensten und -Serverrollen zurück.
-------------------------- Beispiel 2 --------------------------
Get-CsService -ApplicationServer
In Beispiel 2 werden Informationen über den Anwendungsdienst zurückgegeben. Sie können Informationen zu anderen Diensten oder Serverrollen einfach mit dem entsprechenden Parameter zurückgeben. Der folgende Befehl gibt beispielsweise Informationen zum Dateispeicher zurück.
Get-CsService -FileStore
-------------------------- Beispiel 3 --------------------------
Get-CsService -PoolFqdn "atl-cs-001.litwareinc.com" | Select-Object Identity
Der vorstehende Befehl gibt den Identitätswert jedes im Pool "atl-cs-001.litwareinc.com" enthaltenen Diensts zurück. Hierzu ruft der Befehl zunächst Get-CsService und den Parameter "PoolFqdn" auf, um nur die im Pool "atl-cs-001.litwareinc.com" enthaltenden Dienste und Serverrollen zurückzugeben. Diese Auflistung wird dann an das Cmdlet Select-Object weitergeleitet, das den Identitätswert jedes Elements in der Auflistung zurückgibt.
-------------------------- Beispiel 4 --------------------------
Get-CsService | Where-Object {$_.SiteID -eq "site:Redmond"}
In Beispiel 4 werden Informationen zu allen Diensten und Serverrollen am Standort "Redmond" zurückgegeben. Hierzu wird zunächst Get-CsService ohne Parameter aufgerufen, um eine Auflistung aller derzeit in der Organisation verwendeten Dienste und Serverrollen zurückzugeben. Diese Daten werden dann an das Cmdlet Where-Object weitergeleitet, das nur die Elemente herausfiltert, bei denen die Eigenschaft "SiteID" den Wert "site:Redmond" aufweist.
-------------------------- Beispiel 5 --------------------------
Get-CsService | Where-Object {$_.DependentServiceList -like "*Registrar*"}
Der Befehl in Beispiel 5 gibt Informationen zu allen Diensten zurück, die die Registrierung als abhängigen Dienst aufführen. Hierzu wird Get-CsService aufgerufen, um eine Auflistung aller derzeit verwendeten Dienste und Serverrollen zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das jedes Element auswählt, dessen Eigenschaft "DependentServiceList" den Zeichenfolgenwert "Registrar" enthält. Das Kriterium Where-Object wird mit dem Operator "-like" und dem Platzhalterwert "*Registrar*" angegeben.