• Artikel

Remove-CsServerApplication

 

Letztes Änderungsdatum des Themas: 2012-03-27

Entfernt eine vorhandene Serveranwendung. Serveranwendungen sind von Microsoft Lync Server 2010 gehostete Anwendungen.

Syntax

Remove-CsServerApplication -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Serveranwendungen verweisen auf die einzelnen Programme, die unter Lync Server 2010 ausgeführt werden. Mit dem Cmdlet Remove-CsServerApplication können Administratoren alle Anwendungen entfernen, die als Teil von Lync Server ausgeführt werden. Zu beachten ist, dass das Löschen einer Serveranwendung nicht dasselbe wie das Deinstallieren dieser Anwendung bedeutet. Nach Ausführung von Remove-CsServerApplication wird die Anwendung nicht mehr unter Lync Server ausgeführt. Die Software selbst wird jedoch nicht deinstalliert, weshalb die Anwendung durch Ausführung des Cmdlets New-CsServerApplication wieder aktiviert werden kann.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Eindeutige ID der zu entfernenden Serveranwendung. 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.

Force

Optional

Switch-Parameter

Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können.

WhatIf

Optional

Switch-Parameter

Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.

Confirm

Optional

Switch-Parameter

Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf.

Eingabetypen

Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application-Objekt. Remove-CsServerApplication akzeptiert weitergeleitete Instanzen des Serveranwendungsobjekts.

Rückgabetypen

Mit Remove-CsServerApplication werden vorhandene Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application" gelöscht.

Beispiel

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

Remove-CsServerApplication -Identity "service:EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor"

In Beispiel 1 wird die Serveranwendung mit dem Identitätswert "service: EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor" entfernt. Da Identitätswerte eindeutig sein müssen, wird mit diesem Befehl nur eine einzige Serveranwendung gelöscht.

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

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

In Beispiel 2 werden alle nicht kritischen Serveranwendungen entfernt. Hierzu ruft der Befehl zunächst Get-CsServerApplication auf, um eine Auflistung aller derzeit in der Organisation verwendeten Serveranwendungen zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das alle Anwendungen herausfiltert, bei denen die Eigenschaft "Critical" den Wert "False" aufweist. Diese gefilterte Auflistung wird dann an das Cmdlet Remove-CsServerApplication weitergeleitet, das alle Elemente in der Auflistung löscht.

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

Get-CsServerApplication -Filter "service:EdgeServer:atl-cs-001.litwareinc.com/*" | Remove-CsServerApplication

Mit dem vorstehenden Befehl alle Serveranwendungen gelöscht, die für den Dienst "EdgeServer:atl-cs-001.litwareinc.com" konfiguriert wurden. Hierzu ruft der Befehl Get-CsServerApplication zusammen mit dem Parameter "Filter" auf. Der Filterwert "service:EdgeServer:atl-cs-001.litwareinc.com/*" gibt alle Anwendungen mit einem Identitätswert zurück, der mit der Zeichenfolge "service:EdgeServer:atl-cs-001.litwareinc.com/" beginnt. Diese Auflistung wird dann an das Cmdlet Remove-CsServerApplication weitergeleitet, das alle Anwendungen von "EdgeServer:atl-cs-001.litwareinc.com" löscht.