• Artikel

Set-CsServerApplication

 

Letztes Änderungsdatum des Themas: 2012-03-26

Ändert die Eigenschaftswerte einer vorhandenen Serveranwendung. Serveranwendungen sind von Microsoft Lync Server 2010 gehostete Anwendungen.

Syntax

Set-CsServerApplication [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Critical <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Priority <Int32>] [-ScriptName <String>] [-Uri <String>] [-WhatIf [<SwitchParameter>]]

Set-CsServerApplication [-Confirm [<SwitchParameter>]] [-Critical <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Priority <Int32>] [-ScriptName <String>] [-Uri <String>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Serveranwendungen verweisen auf die einzelnen Programme, die unter Lync Server 2010 ausgeführt werden. Mit dem Cmdlet Set-CsServerApplication können Administratoren die Eigenschaftswerte für jede Anwendung ändern, die als Teil von Lync Server ausgeführt wird.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Die eindeutige ID für die Serveranwendung, die geändert 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: Registrar:atl-cs-001.litwareinc.com/QoEAgent.

Instance

Optional

ServerApplication.Application-Objekt

Ermöglicht Ihnen, einen Verweis auf ein Objekt an das Cmdlet zu übergeben, statt individuelle Parameterwerte festzulegen.

Critical

Optional

Boolescher Wert

Ist dieser Wert auf "True" festgelegt, wird Lync Server erst beim Starten der relevanten Anwendung gestartet. Ist für ihn "False" festgelegt, wird Lync Server unabhängig davon gestartet, ob die Anwendung gestartet werden kann.

Enabled

Optional

Boolescher Wert

Legen Sie für diesen Wert "True" fest, um die Anwendung zu aktivieren. Legen Sie "False" fest, um die Anwendung zu deaktivieren.

Priority

Optional

Ganze Zahl

Gibt die Reihenfolge an, in der Serveranwendungen ausgeführt werden. Die Anwendung mit der Priorität 0 wird zuerst gestartet. Als Nächstes folgt die Anwendung mit Priorität 1 usw. Beachten Sie, dass jeder Dienst, der eine Serveranwendung hostet, einen eigenen Satz von Prioritäten aufweist. Der Registrierungsdienst kann beispielsweise drei Anwendungen mit den Prioritäten 0, 1 und 2 hosten. Gleichermaßen kann der Edgeserver über vier Anwendungen mit den Prioritäten 0, 1, 2 und 3 verfügen.

Wenn Sie keine Priorität angeben, wird die Anwendung automatisch am Ende der Prioritätsliste hinzugefügt. Beim Hinzufügen oder Entfernen einer Anwendung ändern sich die Prioritäten der anderen Anwendungen entsprechend. Wenn Sie zum Beispiel eine Anwendung mit Priorität 0 löschen, erhält die Anwendung, die zuvor die Priorität 1 hatte, automatisch die Priorität 0.

ScriptName

Optional

Zeichenfolge

Pfad zum MSPL-Skript (Microsoft SIP Processing Language), das von der Anwendung verwendet wird. MSPL ist eine Skriptsprache, die zum Filtern und Routen von SIP-Nachrichten verwendet wird.

Uri

Optional

Zeichenfolge

Eindeutiger URI (Uniform Resource Identifier) für die Anwendung. Die Anwendung "QoEAgent" hat beispielsweise den URI "https://www.microsoft.com/LCS/QoEAgent".

Force

Optional

Switch-Parameter

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

Confirm

Optional

Switch-Parameter

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

WhatIf

Optional

Switch-Parameter

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

Eingabetypen

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

Rückgabetypen

Set-CsServerApplication gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.application" konfiguriert.

Beispiel

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

Set-CsServerApplication -Identity "Registrar:atl-cs-001.litwareinc.com/ExumRouting" -Enabled $True

Der Befehl in Beispiel 1 aktiviert die Serveranwendung, die den Identitätswert "Registrar:atl-cs-001.litwareinc.com/ExumRouting" aufweist. Da Identitätswerte eindeutig sein müssen, wird mit diesem Befehl nur eine einzige Serveranwendung aktiviert.

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

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

Mit dem vorstehenden Befehl werden alle Serveranwendungen aktiviert, die derzeit deaktiviert sind. Hierzu ruft der Befehl zunächst das Cmdlet 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 die Auflistungen herausfiltert, bei denen die Eigenschaft "Enabled" den Wert "False" aufweist. Die gefilterte Auflistung wird dann an das Cmdlet Set-CsServerApplication weitergeleitet, das die Eigenschaft "Enabled" von jedem Element in der Auflistung auf "True" festlegt.