Set-CsMcxConfiguration
Letztes Änderungsdatum des Themas: 2012-04-23
Ändert eine vorhandene Auflistung von Konfigurationseinstellungen für den Microsoft Lync Server 2010-Mobilitätsdienst. Dieser Dienst ermöglicht Benutzern von Mobiltelefonen wie iPhones und Windows Phones das Austauschen von Sofortnachrichten und Anwesenheitsinformationen, das interne Speichern und Abrufen von Voicemail anstatt beim Mobilfunkanbieter und das Ausnutzen von Microsoft Lync Server 2010-Funktionen wie "Geschäftlich anrufen" und der Konferenzoption für ausgehende Verbindungen.
Syntax
Set-CsMcxConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-ExposedWebURL <External | Internal>] [-Force <SwitchParameter>] [-PushNotificationProxyUri <String>] [-SessionExpirationInterval <UInt32>] [-SessionShortExpirationInterval <UInt32>] [-WhatIf [<SwitchParameter>]]
Set-CsMcxConfiguration [-Confirm [<SwitchParameter>]] [-ExposedWebURL <External | Internal>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-PushNotificationProxyUri <String>] [-SessionExpirationInterval <UInt32>] [-SessionShortExpirationInterval <UInt32>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Der Microsoft Lync Server 2010-Mobilitätsdienst stellt viele der Funktionen von Microsoft Lync 2010 mobilen Geräten wie Apple iPhones, Windows Phones, Android- und Nokia-Telefonen zur Verfügung. Neben anderen Dingen können Benutzer dieser Telefone Sofortnachrichten und Anwesenheitsinformationen austauschen sowie Benachrichtigungen zu neuen Voicemails empfangen. Dank des Pushbenachrichtigungsdiensts (Apple-Pushbenachrichtigungsdienst und Microsoft Lync Server 2010-Pushbenachrichtigungsdienst) können Benutzer von iPhones oder Windows Phones diese Benachrichtigungen auch dann empfangen, wenn Lync 2010 im Hintergrund ausgeführt wird. Der Mobilitätsdienst bietet Organisationen auch die Möglichkeit, die Funktion "Geschäftlich anrufen" zu aktivieren. Diese Funktion ermöglicht es Benutzern, Anrufe auf ihrem Mobiltelefon zu tätigen und so erscheinen zu lassen, als würde der Anruf von ihrer geschäftlichen Telefonnummer stammen. Anrufer-ID-Systeme zeigen beispielsweise die geschäftliche Nummer des Benutzers und nicht seine Mobilfunknummer an.
Der Mobilitätsdienst selbst wird mithilfe von Konfigurationseinstellungen verwaltet, die auf globaler, Standort- oder Dienstebene gelten (nur für den Webserverdienst) können. Diese Einstellungen steuern beispielsweise die maximale Dauer einer Mobilitätsdienstsitzung, ob der Microsoft Lync Server 2010-AutoErmittlungsdienst (der Benutzer des Mobilitätsdiensts auf den entsprechenden Registrierungspool verweist) Benutzern zur Verfügung steht, die sich außerhalb der Firewall der Organisation anmelden, und den Standort des Anbieters des Pushbenachrichtigungsdiensts.
Mit dem Cmdlet Set-CsMcxConfiguration können Administratoren für den Mobilitätsdienst geltende Konfigurationseinstellungen ändern.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Set-CsMcxConfiguration lokal auszuführen: RTCUniversalServerAdmins.
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
XdsIdentity |
Eindeutige ID der zu ändernden Konfigurationseinstellungen für den Mobilitätsdienst. Verwenden Sie folgende Syntax, um die globalen Einstellungen zu ändern: -Identity global Zum Ändern der Einstellungen auf Standortebene verwenden Sie das Präfix "site:" gefolgt von dem Standortnamen. Beispiel: -Identity "site:Redmond" Verwenden Sie eine Syntax wie die folgende, um die auf Dienstebene konfigurierten Einstellungen zu ändern: -Identity service:WebServer:atl-cs-001.litwareinc.com Wenn dieser Parameter nicht angegeben wird, ändert Set-CsMcxConfiguration die globalen Einstellungen. |
ExposedWebURL |
Optional |
Objekt "ExposedWebURL" |
Gibt an, ob die vom AutoErmittlungsdienst verwendete URL Benutzern sowohl außerhalb als auch innerhalb der Firewall der Organisation (External) oder nur Benutzern innerhalb der Firewall (Internal) zur Verfügung steht. Zulässige Werte: "Internal" oder "External". Der Standardwert ist "External". |
Instance |
Optional |
MCX-Konfigurationsobjekt |
Ermöglicht Ihnen, einen Verweis auf ein Objekt an das Cmdlet zu übergeben, statt individuelle Parameterwerte festzulegen. |
PushNotificationProxyUri |
Optional |
Zeichenfolge |
URI eines Dienstanbieters, der Pushbenachrichtigungsanforderungen sowohl an den Apple-Pushbenachrichtigungsdienst als auch an den Microsoft Lync Server 2010-Pushbenachrichtigungsdienst weiterleiten kann. Die Eigenschaft "PushNotificationProxyUri" muss das Format einer SIP-Adresse haben. Beispiel: -PushNotificationProxyUri "sip:push@push.lync.com" |
SessionExpirationInterval |
Optional |
Ganze Zahl |
Dauer (in Sekunden) einer mobilen Sitzung für iPhone- oder Windows Phone-Benutzer. Wenn Lync 2010 im Hintergrund ausgeführt werden, erhalten Benutzer Pushbenachrichtigungen, solange das Sitzungsablaufintervall nicht abgelaufen ist. Das mobile Gerät muss einen Hinweis an den Server senden, dass das Gerät noch aktiv ist, bevor das Zeitlimit der Sitzung erreicht ist. Erfolgt dies nicht, wird das Gerät als inaktiv angegeben, sodass sich der Benutzer nochmals beim System anmelden muss. Diese Eigenschaft kann auf einen beliebigen ganzzahligen Wert von 120 bis 4294967295 festgelegt werden. Der Standardwert ist 259200 (drei Tage). Der Wert der Eigenschaft "SessionExpirationInterval" muss größer als der Wert der Eigenschaft "SessionShortExpirationInterval" sein. |
SessionShortExpirationInterval |
Optional |
Ganze Zahl |
Dauer (in Sekunden) einer mobilen Sitzung für Benutzer von Android- und Nokia-Telefonen. Das mobile Gerät muss einen Hinweis an den Server senden, dass das Gerät noch aktiv ist, bevor das Zeitlimit der Sitzung erreicht ist. Erfolgt dies nicht, wird das Gerät als inaktiv angegeben, sodass sich der Benutzer nochmals beim System anmelden muss. Diese Eigenschaft kann auf einen beliebigen ganzzahligen Wert von 120 bis 4294967295 festgelegt werden. Der Standardwert ist 259200 (drei Tage). Der Wert der Eigenschaft "SessionExpirationInterval" muss größer als der Wert der Eigenschaft "SessionShortExpirationInterval" sein. |
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
Objekt "Microsoft.Rtc.Management.WriteableConfig.Settings.McxConfiguration.McxConfiguration". Set-CsMcxConfiguration akzeptiert weitergeleitete Instanzen des Objekts "McxConfiguration".
Rückgabetypen
Keine. Mit Set-CsMcxConfiguration werden stattdessen vorhandene Instanzen des Objekts "Microsoft.Rtc.Management.WriteableConfig.Settings.McxConfiguration.McxConfiguration" geändert.
Beispiel
-------------------------- Beispiel 1 --------------------------
Set-CsMcxConfiguration -Identity site:Redmond -ExposedWebURL External
In Beispiel 1 wird die Eigenschaft "ExposedWebURL" für die Konfigurationseinstellungen des Mobilitätsdiensts, die dem Standort "Redmond" zugewiesen sind, auf "External" festgelegt.
-------------------------- Beispiel 2 --------------------------
Get-CsMcxConfiguration | Set-CsMcxConfiguration -ExposedWebURL External
Beispiel 2 zeigt, wie über einen einzelnen Befehl derselbe Eigenschaftswert allen Konfigurationseinstellungen für den Mobilitätsdienst zugewiesen werden kann, die derzeit in einer Organisation verwendet werden. Hierzu wird in dem Befehl zunächst das Cmdlet Get-CsMcxConfiguration ohne Parameter aufgerufen, um eine Auflistung aller vorhandenen Konfigurationseinstellungen für den Mobilitätsdienst zurückzugeben. Diese Auflistung wird dann an das Cmdlet Set-CsMcxConfiguration weitergeleitet, das die Eigenschaft "ExposedWebURL" für jedes Element in der Auflistung auf "External" festlegt.
-------------------------- Beispiel 3 --------------------------
Get-CsMcxConfiguration | Where-Object {$_.SessionShortExpirationInterval -gt 3600} | Set-CsMcxConfiguration -SessionShortExpirationInterval 3600
Bei diesem Beispiel werden alle Konfigurationseinstellungen für den Mobilitätsdienst, bei denen die Eigenschaft "SessionShortExpirationInterval" auf mehr als 3600 Sekunden festgelegt ist, auf den Eigenschaftswert 3600 festgelegt. Dadurch sind 3600 Sekunden der Höchstwert für alle Konfigurationseinstellungen für den Mobilitätsdienst in der Organisation. Hierzu ruft der Befehl zunächst Get-CsMcxConfiguration ohne Parameter auf, um eine Auflistung aller Konfigurationseinstellungen für den Mobilitätsdienst zurückzugeben, die derzeit in der Organisation gelten. Diese Auflistung wird dann an das Cmdlet "Where-Object" weitergeleitet, das die nur Einstellungen herausfiltert, bei denen die Eigenschaft "SessionShortExpirationInterval" größer als 3600 ist (der Vergleichsoperator "-gt" steht für "greater than"). Diese Auflistung wird dann an das Cmdlet Set-CsMcxConfiguration weitergeleitet, das den Wert der Eigenschaft "SessionShortExpirationInterval" für jedes Element in der Auflistung auf "3600" festlegt.