• Artikel

New-CsServerApplication

 

Letztes Änderungsdatum des Themas: 2012-03-26

Erstellt eine neue Serveranwendung. Serveranwendungen sind von Microsoft Lync Server 2010 gehostete Anwendungen.

Syntax

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

New-CsServerApplication -Name <String> -Parent <String> -Uri <String> [-Confirm [<SwitchParameter>]] [-Critical <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Priority <Int32>] [-ScriptName <String>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Serveranwendungen verweisen auf die einzelnen Programme, die unter Microsoft Lync Server 2010 ausgeführt werden. Das Cmdlet New-CsServerApplication bietet Administratoren eine Möglichkeit zum Konfigurieren neuer Serveranwendungen.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Eindeutige ID für die zu erstellende 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.

Parent

Erforderlich

Zeichenfolge

Gibt den Dienst an, der die neue Serveranwendung hostet. Wenn Sie den Parameter "Identity" verwenden, sind sowohl "Parent" als auch "Name" überflüssig, da der Identitätswert der Anwendung die Werte der Eigenschaften "Parent" und "Name" verknüpft. Sie können allerdings den Parameter "Identity" auslassen und stattdessen "Parent" und "Name" verwenden. In diesem Fall sieht der Parameter "Parent" in etwa wie folgt aus: -Parent "Registrar:atl-cs-001.litwareinc.com".

Name

Erforderlich

Zeichenfolge

Der Anzeigename des Diensts. Wenn Sie den Parameter "Identity" verwenden, ist beim Erstellen eines neuen Diensts der Parameter "Name" nicht erforderlich. Die Eigenschaft "Name" wird stattdessen mit dem Namensbestandteil der Anwendungsidentität aufgefüllt. Wenn Sie beispielsweise eine neue Anwendung mit dem Identitätswert "service:Registrar:atl-cs-001.litwareinc.com/TestService" erstellen, lautet der Anwendungsname automatisch "TestService". Der Parameter "Name" ist nur bei Verwendung des Parameters "Parent" erforderlich.

Uri

Erforderlich

Zeichenfolge

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

Enabled

Optional

Boolescher Wert

Legen Sie für diesen Wert "True" fest, um die Anwendung zu aktivieren. Legen Sie den Wert auf "False" fest, um die Anwendung zu deaktivieren. Wird dieser Parameter nicht angegeben, wird die Eigenschaft "Enabled" auf "False" festgelegt, und die neue Anwendung wird deaktiviert.

Critical

Optional

Boolescher Wert

Ist dieser Wert auf "True" festgelegt, wird Lync Server erst beim Starten der relevanten Anwendung gestartet. Ist "False" festgelegt, wird Lync Server unabhängig davon gestartet, ob die Anwendung gestartet werden kann. Wird dieser Parameter nicht angegeben, wird die Eigenschaft "Critical" auf "True" festgelegt.

ScriptName

Optional

Zeichenfolge

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

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 Priorität 1 hatte, automatisch Priorität 0.

InMemory

Optional

Switch-Parameter

Erstellt einen Objektverweis ohne einen Commit für das Objekt auszuführen und die Änderungen dadurch dauerhaft zu speichern. Wenn Sie die Ausgabe des mit diesem Parameter aufgerufenen Cmdlet einer Variablen zuweisen, können Sie die Eigenschaften des Objektverweises ändern und anschließend einen Commit für diese Änderungen ausführen, indem Sie das entsprechende Cmdlet vom Typ "Set-" aufrufen.

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

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

Eingabetypen

Keine. New-CsServerApplication akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit New-CsServerApplication werden neue Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application" erstellt.

Beispiel

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

New-CsServerApplication -Identity "EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor" -Uri http://www.litwareinc.com/edgemonitor -Critical $False

In Beispiel 1 wird eine neue Serveranwendung mit dem Identitätswert "EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor" erstellt. Neben dem Identitätswert werden auch die Parameter "Uri" und "Critical" angegeben. Diese dienen zum Angeben des Anwendungs-URIs und weisen darauf hin, dass die Anwendung nicht als kritisch betrachtet wird.

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

$x = New-CsServerApplication -Identity "EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor" -InMemory
$x.Uri = "http://www.litwareinc.com/edgemonitor"
$x.Critical = $False
Set-CsServerApplication -Instance $x

Die Befehle in Beispiel 2 zeigen, wie Sie eine neue Serveranwendung erstellen können, die nur im Speicher vorhanden ist. Hierzu ruft der erste Befehl das Cmdlet New-CsServerApplication mit zwei Parametern auf: "Identity", der den Identitätswert der Anwendung angibt, und "InMemory", der angibt, dass die neue Anwendung nur im Arbeitsspeicher erstellt werden soll. Das resultierende Serveranwendungsobjekt wird in der Variablen "$x" gespeichert.

Nach der Erstellung dieser virtuellen Serveranwendung werden die Werte der Eigenschaften "Uri" und "Critical" mit Befehl 2 und 3 geändert. Zum Schluss wird die virtuelle Serveranwendung mit Befehl 4 in eine tatsächliche Serveranwendung umgewandelt. Dieser letzte Befehl ist verbindlich. Wenn Sie Set-CsServerApplication nicht aufrufen, wird keine Anwendung für "EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor" konfiguriert, und die virtuelle Anwendung geht verloren, sobald Sie die Windows PowerShell-Sitzung beenden oder die Variable "$x" löschen.