Get-CsServerApplication

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen zu den in Ihrer Organisation verwendeten Serveranwendungen zurück. Serveranwendungen sind von Microsoft Lync Server 2010 gehostete Anwendungen.

Syntax

Get-CsServerApplication [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsServerApplication [-Filter <String>] [-LocalStore <SwitchParameter>]

Detaillierte Beschreibung

Serveranwendungen verweisen auf die einzelnen Programme, die unter Lync Server 2010 ausgeführt werden. Mit dem Cmdlet Get-CsServerApplication können Administratoren Informationen zu beliebigen (oder allen) Anwendungen abrufen, die als Teil von Lync Server ausgeführt werden.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Get-CsServerApplication 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-CsServerApplication"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Die eindeutige ID für die Serveranwendung, die abgerufen werden soll. Die Identitätswerte für Serveranwendungen bestehen aus dem Dienst, der die Anwendung hostet, und dem Anwendungsnamen. Die Serveranwendung "QoEAgent" hat möglicherweise einen Identitätswert wie folgenden: service: Registrar:atl-cs-001.litwareinc.com/QoEAgent.

Wenn Sie eine Auflistung aller Anwendungen abrufen möchten, die auf einem bestimmten Dienst ausgeführt werden, lassen Sie einfach den Anwendungsnamen weg:

-Identity "Registrar:atl-cs-001.litwareinc.com"

Wenn dieser Parameter ausgelassen wird, werden durch Aufrufen von Get-CsServerApplication alle Serveranwendungen zurückgegeben.

Filter

Optional

Zeichenfolge

Ermöglicht die Verwendung von Platzhalterzeichen beim Zurückgeben einer oder mehrerer Serveranwendungen. Verwenden Sie z. B. folgende Syntax, um alle Serveranwendungen zurückzugeben, deren Identitätswert die Zeichenfolge "IIMFilter" enthalten: -Filter "*IIMFilter*".

LocalStore

Optional

Switch-Parameter

Ruft die Serveranwendungsdaten aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Keine. Get-CsServerApplication akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit Get-CsServerApplication werden Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application" zurückgegeben.

Beispiel

-------------------------- Beispiel 1 ------------------------

Get-CsServerApplication

Der Befehl in Beispiel 1 gibt Informationen zu allen derzeit in der Organisation verwendeten Serveranwendungen zurück. Dazu wird Get-CsServerApplication ohne Parameter aufgerufen.

-------------------------- Beispiel 2 --------------------------

Get-CsServerApplication -Identity "service:EdgeServer:atl-edge-001.litwareinc.com"

In Beispiel 2 werden Informationen zu allen Serveranwendungen zurückgegeben, die auf dem Dienst "EdgeServer:atl-edge-001.litwareinc.com" ausgeführt werden.

-------------------------- Beispiel 3 --------------------------

Get-CsServerApplication -Identity "service:Registrar:atl-cs-001.litwareinc.com/ExumRouting"

Mit Beispiel 3 werden Informationen zu einer einzelnen Serveranwendung zurückgegeben: der Anwendung mit Identitätswert "Registrar:atl-cs-001.litwareinc.com/ExumRouting".

-------------------------- Beispiel 4 --------------------------

Get-CsServerApplication -Filter "service:*:atl-cs-001.litwareinc.com*"

Mit dem vorstehenden Befehl werden alle Serveranwendungen zurückgegeben, die für die Verwendung in dem Pool "atl-cs-001.litwareinc.com" konfiguriert wurden. Hierzu werden der Parameter "Filter" und der Filterwert "service:*:atl-cs-001.litwareinc.com*" verwendet. Dieser Filterwert beschränkt die zurückgegebenen Daten auf Anwendungen, deren Identitätswert mit dem Zeichenfolgenwert "service:" beginnt und die Zeichen ":atl-cs-001.litwareinc.com" enthält.

-------------------------- Beispiel 5 --------------------------

Get-CsServerApplication | Where-Object {$_.Enabled -eq $False}

In Beispiel 5 werden Informationen zu allen Serveranwendungen zurückgegeben, die derzeit deaktiviert sind. Hierzu ruft der Befehl zunächst Get-CsServerApplication auf, um eine Auflistung aller für die Verwendung in der Organisation konfigurierten Serveranwendungen zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Anwendungen herausfiltert, bei denen die Eigenschaft "Enabled" den Wert "False" aufweist.

-------------------------- Beispiel 6 --------------------------

Get-CsServerApplication | Where-Object {$_.Critical -eq $True -and $_.Enabled -eq $False}

Beispiel 6 ist eine Variante des in Beispiel 5 gezeigten Befehls. In Beispiel 6 werden Informationen zu allen Serveranwendungen zurückgegeben, die als kritisch gekennzeichnet und derzeit deaktiviert sind. Hierzu ruft der Befehl zunächst Get-CsServerApplication ohne Parameter auf. Damit wird eine Auflistung aller für die Verwendung konfigurierten Serveranwendungen zurückgegeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur die Anwendungen herausfiltert, die die folgenden zwei Kriterien erfüllen: Die Eigenschaft "Critical" und die Eigenschaft "Enabled" weisen den Wert "True" auf. Der Operator "-and" stellt sicher, dass nur Objekte zurückgegeben werden, die beide Kriterien erfüllen.

-------------------------- Beispiel 7 ------------------------

Get-CsServerApplication | Where-Object {$_.Uri -like "*routing*"}

In Beispiel 7 werden Informationen zu allen Serveranwendungen zurückgegeben, die den Zeichenfolgenwert "routing" in ihrem Uri aufweisen. Hierzu werden zunächst mit Get-CsServerApplication alle derzeit verwendeten Serveranwendungen aufgerufen. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur solche Anwendungen herausfiltert, deren Eigenschaft "Uri" den Zeichenfolgenwert "routing" enthält.

-------------------------- Beispiel 8 ------------------------

Get-CsServerApplication | Where-Object {$_.ScriptName -ne $Null}

Mit dem vorstehenden Befehl werden Informationen zu allen Serveranwendungen zurückgegeben, denen ein Skript zugewiesen wurde. Hierzu ruft der Befehl zunächst eine Auflistung aller derzeit verwendeten Serveranwendungen ab. Diese Informationen werden durch Aufrufen des Cmdlets Get-CsServerApplication" ohne Parameter abgerufen. Die gesamte Auflistung der Serveranwendungen wird dann an das Cmdlet Where-Object weitergeleitet, das nur die Anwendungen herausfiltert, bei denen die Eigenschaft "ScriptName" keinen Nullwert aufweist.. Wenn die Eigenschaft "ScriptName" keinen Nullwert aufweist, bedeutet dies, dass dieser Anwendung ein Skript zugewiesen wurde.