Remove-CsMcxConfiguration
Letztes Änderungsdatum des Themas: 2012-04-23
Entfernt die angegebene 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
Remove-CsMcxConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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.
Bei der Installation von Lync Server 2010 wird eine einzelne Auflistung von Konfigurationseinstellungen für den Mobilitätsdienst auf globaler Ebene erstellt. Administratoren können jedoch benutzerdefinierte Konfigurationseinstellungen auf Standort- oder Dienstebene festlegen, die später mithilfe des Cmdlets Remove-CsMcxConfiguration wieder aufgehoben werden können. Wenn Sie Diensteinstellungen entfernen, werden zuvor diesen Einstellungen unterliegende Mobilitätsdienstserver mithilfe der Standorteinstellungen (sofern vorhanden) oder globalen Einstellungen verwaltet. Wenn Sie Standorteinstellungen entfernen, unterliegen Server den globalen Einstellungen.
Sie können das Cmdlet Remove-CsMcxConfiguration auch auf die globalen Einstellungen anwenden, die dann allerdings nicht entfernt werden. Stattdessen werden die Eigenschaften in der globalen Auflistung auf ihre Standardwerte zurückgesetzt.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Remove-CsMcxConfiguration lokal auszuführen: RTCUniversalServerAdmins.
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
XdsIdentity |
Eindeutige ID für die zu entfernenden Konfigurationseinstellungen für den Mobilitätsdienst. Verwenden Sie folgende Syntax, um die globalen Einstellungen zu ändern: -Identity global Hinweis: Wie bereits erwähnt, können Sie die globalen Einstellungen nicht wirklich entfernen. Sie können bloß die Eigenschaften auf ihre Standardwerte zurücksetzen. Verwenden Sie eine Syntax wie die folgende, um die Einstellungen auf Standortebene zu entfernen: -Identity site:Redmond. Verwenden Sie eine Syntax wie die folgende, um die auf Dienstebene konfigurierten Einstellungen zu entfernen: -Identity service:WebServer:atl-cs-001.litwareinc.com Sie können beim Angeben eines Identitätswerts keine Platzhalter verwenden. |
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.WriteableConfig.Settings.McxConfiguration.McxConfiguration. Remove-CsMcxConfiguration akzeptiert weitergeleitete Eingaben von "McxConfiguration"-Objekten.
Rückgabetypen
Keine. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WriteableConfig.Settings.McxConfiguration.McxConfiguration" gelöscht.
Beispiel
-------------------------- Beispiel 1 --------------------------
Remove-CsMcxConfiguration -Identity "site:Redmond"
Mit dem Befehl in Beispiel 1 wird die Auflistung der Konfigurationseinstellungen für den Mobilitätsdienst gelöscht, die dem Standort "Redmond" zugewiesen sind.
-------------------------- Beispiel 2 --------------------------
Get-CsMcxConfiguration -Filter "service:*" | Remove-CsMcxConfiguration
In Beispiel 2 werden alle dem Mobilitätsdienst auf Dienstebene zugewiesenen Konfigurationseinstellungen entfernt. Hierzu wird das Cmdlet Get-CsMcxConfiguration mit dem Parameter "Filter" angegeben. Der Filterwert "service:*" stellt sicher, dass nur Einstellungen zurückgegeben werden, deren Identitätswert mit dem Zeichenfolgenwert "service:" beginnt. Diese gefilterte Auflistung wird anschließend an das Cmdlet Remove-CsMcxConfiguration weitergeleitet und von diesem gelöscht.
-------------------------- Beispiel 3 --------------------------
Get-CsMcxConfiguration | Where-Object {$_.ExposedWebURL -eq "Internal"} | Remove-CsMcxConfiguration
Mit diesem Befehl werden alle Konfigurationseinstellungen des Mobilitätsdiensts gelöscht, bei denen die Eigenschaft "ExposedWebURL" auf "Internal" festgelegt ist. Hierzu ruft der Befehl zunächst das Cmdlet Get-CsMcxConfiguration ohne Parameter auf, wodurch eine Auflistung aller aktuellen Konfigurationseinstellungen für den Mobilitätsdienst in der Organisation zurückgegeben wird. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Einstellungen auswählt, bei denen "ExposedWebURL" gleich (-eq) "Internal" ist. Diese gefilterte Auflistung wird danach an das Remove-CsMcxConfiguration weitergeleitet, das alle Elemente aus dieser gefilterten Auflistung löscht.
-------------------------- Beispiel 4 --------------------------
Get-CsMcxConfiguration | Where-Object {$_.PushNotificationProxyUri -eq $Null} | Remove-CsMcxConfiguration
In Beispiel 4 werden alle Konfigurationseinstellungen des Mobilitätsdienst ohne zugewiesenen Pushbenachrichtigungsproxy-URI aus Lync Server entfernt. Hierzu wird im ersten Befehl das Cmdlet Get-CsMcxConfiguration (ohne Parameter) verwendet, um alle derzeit verwendeten Konfigurationseinstellungen des Mobilitätsdienst zurückzugeben. Diese Auflistung wird anschließend an das Cmdlet Where-Object weitergeleitet, das alle Einstellungen herausfiltert, bei denen die Eigenschaft "PushNotificationProxyUri" den Wert "Null" hat. Einstellungen, die dieses Kriterium erfüllen, werden dann an das Cmdlet Remove-CsMcxConfiguration weitergeleitet und von diesem gelöscht.