Set-CsApplicationServer
Letztes Änderungsdatum des Themas: 2012-03-27
Ermöglicht es Ihnen, Konfigurationseigenschaften eines oder mehrerer Server zu ändern, auf denen der Anwendungsdienst ausgeführt wird. Auf diesen auch als Anwendungsserver bezeichneten Servern werden Softwareprogramme wie die Anwendung zum Parken von Anrufen gehostet, die mit dem Microsoft Unified Communications Managed-API (UCMA)-Satz entwickelt wurden.
Syntax
Set-CsApplicationServer [-Identity <XdsGlobalRelativeIdentity>] [-ApplicationDatabase <String>] [-AppSharingPortCount <UInt16>] [-AppSharingPortStart <UInt16>] [-AtsSipPort <UInt16>] [-AudioPortCount <UInt16>] [-AudioPortStart <UInt16>] [-CaaSipPort <UInt16>] [-CasSipPort <UInt16>] [-Confirm [<SwitchParameter>]] [-CpsSipPort <UInt16>] [-Force <SwitchParameter>] [-PdpSipPort <UInt16>] [-PdpTurnPort <UInt16>] [-Registrar <String>] [-RgsSipPort <UInt16>] [-RgsWcfMtlsPort <UInt16>] [-VideoPortCount <UInt16>] [-VideoPortStart <UInt16>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Der Anwendungsdienst hostet eine Reihe von Microsoft Lync Server 2010-Programmen, die nicht zu den Hauptserverkomponenten zählen. Zu diesen Programmen gehören die Reaktionsgruppenanwendung, die Konferenzzentrale und die Konferenzankündigungsanwendung. Über den Anwendungsdienst werden diese Programme vollständig in die Lync Server 2010-Umgebung integriert.
Mit dem Cmdlet Set-CsApplicationServer können Administratoren die Konfigurationseinstellungen für die in ihrer Organisation bereitgestellten Anwendungsserver ändern. Beispielsweise können die für den Datenverkehr bei Audio- und Videoübertragungen oder bei der Anwendungsfreigabe verwendeten Ports geändert werden, oder Sie können neue Werte für Ports zuweisen, die von einzelnen Anwendungen wie der Konferenzzentraleoder der Konferenzankündigungsanwendung verwendet werden. Beachten Sie, dass Sie bei jeder Änderung der Ports den entsprechenden Dienst neu starten müssen.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Set-CsApplicationServer lokal ausfü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-CsApplicationServer"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
XdsIdentity |
Dienstidentifizierung des zu ändernden Anwendungsservers. Beispiel: -Identity "ApplicationServer:atl-cs-001.litwareinc.com". Beachten Sie, dass Sie das Präfix "ApplicationServer:" auslassen können, wenn Sie einen Anwendungsserver angeben. Beispiel: -Identity "atl-cs-001.litwareinc.com". |
ApplicationDatabase |
Optional |
Zeichenfolge |
Dienstidentifizierung der Anwendungsdatenbank. Beispiel: -ApplicationDatabase "ApplicationDatabase:atl-cs-001.litwareinc.com". |
AppSharingPortCount |
Optional |
Ganze Zahl |
Die Gesamtanzahl von Ports, die für die Anwendungsfreigabe zugewiesen sind. Die Ports, die tatsächlich geöffnet werden sollen, beginnen mit dem unter "AppSharingPortStart" festgelegten Wert. Von diesem Wert ausgehend wird die unter "AppSharingPortCount" festgelegte Anzahl von Ports geöffnet. Wenn für "AppSharingPortStart" z. B. der Wert 60000 und für "AppSharingPortCount" der Wert 100 festgelegt ist, werden die Ports 60000 bis 60099 für die Anwendungsfreigabe verwendet. |
AppSharingPortStart |
Optional |
Ganze Zahl |
Der erste Port im für die Anwendungsfreigabe zugewiesenen Portbereich. Beispiel: –AppSharingPortStart 60000. |
AtsSipPort |
Optional |
Ganze Zahl |
Für den Audiotestdienst verwendeter Port. |
AudioPortCount |
Optional |
Ganze Zahl |
Gesamtanzahl von Ports, die für das Senden und Empfangen von Audiodaten genutzt werden. Die Ports, die tatsächlich geöffnet werden sollen, beginnen mit dem unter "AudioPortStart" festgelegten Wert. Von diesem Wert ausgehend wird die unter "AudioPortCount" festgelegte Anzahl von Ports geöffnet. Wenn "AudioPortStart" beispielsweise auf 60000 und "AudioPortCount" auf 100 festgelegt wurde, werden die Ports 60000 bis 60099 für den Audiodatenverkehr genutzt. |
AudioPortStart |
Optional |
Ganze Zahl |
Der erste Port in dem für das Senden und Empfangen von Audiodaten zugewiesenen Portbereich. Beispiel: –AudioPortStart 60000. |
CaaSipPort |
Optional |
Ganze Zahl |
Von der Konferenzzentrale verwendeter SIP-Port zur Verbindung von Benutzern mit einer Einwahlkonferenz. |
CasSipPort |
Optional |
Ganze Zahl |
Von der Konferenzankündigungsanwendung verwendeter SIP-Port zur Wiedergabe von Ansagen (z. B. "Ken Myer verlässt die Konferenz") während einer Konferenz. |
CpsSipPort |
Optional |
Ganze Zahl |
Der vom Dienst für das Parken von Anrufen verwendete SIP-Port. Mit dem Dienst für das Parken von Anrufen kann ein Anruf von einem Telefon aus in der Warteschleife platziert und anschließend an einem anderen Telefon entgegengenommen werden. |
PdpSipPort |
Optional |
Ganze Zahl |
Der vom Policy Decision Point-Server verwendete SIP-Port. Der Policy Decision Point-Server wird zur Bandbreitenverwaltung verwendet. |
PdpTurnPort |
Optional |
Ganze Zahl |
Der vom Policy Decision Point-Server verwendete TURN-Port. |
Registrar |
Optional |
Zeichenfolge |
Vollqualifizierter Domänenname der Registrierung, die dem Server mit dem Policy Decision Point zugeordnet ist. |
RgsSipPort |
Optional |
Ganze Zahl |
Der von der Reaktionsgruppenanwendung verwendete SIP-Port. Die Reaktionsgruppenanwendung bietet eine Möglichkeit zur Umleitung eingehender Telefonanrufe an eine bestimmte Personengruppe, beispielsweise das Supportteam einer Organisation. |
RgsWcfMtlsPort |
Optional |
Ganze Zahl |
Von der Reaktionsgruppenanwendung verwendeter Port für MTLS-Datenverkehr (Mutual Transport Security Layer) von WCF (Windows Communication Foundation). |
VideoPortCount |
Optional |
Ganze Zahl |
Gesamtanzahl von Ports, die für das Senden und Empfangen von Videodaten genutzt werden. Die Ports, die tatsächlich geöffnet werden sollen, beginnen mit dem unter "VideoPortStart" festgelegten Wert. Von diesem Wert ausgehend wird die unter "VideoPortCount" festgelegte Anzahl von Ports geöffnet. Wenn "VideoPortStart" beispielsweise auf 60000 und "VideoPortCount" auf 100 festgelegt wird, werden die Ports 60000 bis 60099 für den Videodatenverkehr genutzt. |
VideoPortStart |
Optional |
Ganze Zahl |
Der erste Port in dem für das Senden und Empfangen von Videodaten zugewiesenen Portbereich. Beispiel: –VideoPortStart 60000. |
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
Keine. Set-CsApplicationServer akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Set-CsApplicationServer gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet vorhandene Instanzen des Objekts "Microsoft.Rtc.Management.Xds.DisplayApplicationServer" geändert.
Beispiel
-------------------------- Beispiel 1 ------------------------
Set-CsApplicationServer -Identity "ApplicationServer:atl-cs-001.litwareinc.com" -CasSipPort 5074
Über den Befehl in Beispiel 1 wird der SIP-Port für die Konferenzankündigungsanwendung auf dem Anwendungsserver "ApplicationServer:atl-cs-001.litwareinc.com" auf 5074 festgelegt.
-------------------------- Beispiel 2 ------------------------
Set-CsApplicationServer -Identity "ApplicationServer:atl-cs-001.litwareinc.com" -AudioPortStart 49500 -AudioPortCount 5500
Mit dem vorstehenden Befehl werden die Audioports für den Anwendungsserver "ApplicationServer:atl-cs-001.litwareinc.com" konfiguriert. In diesem Beispiel wird der Startaudioport auf 49500 festgelegt, und für den Audiodatenverkehr werden insgesamt 5500 Ports reserviert.
-------------------------- Beispiel 3 ------------------------
Get-CsService -ApplicationServer | ForEach-Object {Set-CsApplicationServer -Identity $_.Identity -CasSipPort 5074}
In Beispiel 3 wird der SIP-Port für die Konferenzankündigungsanwendung auf allen Anwendungsservern in der Organisation auf 5074 festgelegt. Hierzu ruft der Befehl zunächst Get-CsService auf, um eine Auflistung aller derzeit verwendeten Anwendungsserver zurückzugeben. Diese Auflistung wird anschließend an das Cmdlet ForEach-Object weitergeleitet, das mithilfe des Cmdlets Set-CsApplicationServer den SIP-Port für die Konferenzankündigungsanwendung für alle Server auf 5074 festlegt.