• Artikel

Remove-CsUCPhoneConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-26

Entfernt die angegebene Auflistung von Microsoft Lync 2010 Phone Edition-Konfigurationseinstellungen. Zu diesen Einstellungen gehören beispielsweise der erforderliche Sicherheitsmodus und die Angabe, ob das Telefon nach einem bestimmten Zeitraum der Inaktivität automatisch gesperrt werden soll.

Syntax

Remove-CsUCPhoneConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

In Lync 2010 Phone Edition werden die Funktionen von Telefon und Microsoft Lync 2010 zusammengeführt. Lync 2010 Phone Edition nutzt ein spezielles Gerät (d. h. ein mit Lync 2010 kompatibles Telefon), das als VoIP-Telefon verwendet werden kann. Darüber hinaus kann diese Hardware auch als Lync 2010-ähnlicher Endpunkt genutzt werden: Sie können den aktuellen Status festlegen, den Status Ihrer Lync 2010-Kontakte überprüfen, nach neuen Kontakten suchen und viele andere Aktivitäten ausführen, die Sie von Lync kennen.

Zum Lieferumfang von Microsoft Lync Server 2010 gehört eine Reihe von Cmdlets, mit denen Sie Ihre Lync 2010-Telefone verwalten können. Sie können z. B. die Mindestlänge der zur Anmeldung am Telefon erforderlichen persönlichen Identifikationsnummer (PIN) festlegen und bestimmen, ob das Telefon nach einem bestimmten Zeitraum der Inaktivität automatisch gesperrt wird.

Konfigurationseinstellungen für das UC-Telefon (Unified Communications) können entweder global oder auf Standortebene zugewiesen werden. (Auf Standortebene zugewiesene Einstellungen haben Vorrang vor den global zugewiesenen Einstellungen.) Bei der Installation von Lync Server 2010 wird ein einzelner Satz mit UC-Telefonkonfigurationseinstellungen erstellt und global zugewiesen. Sie können jedoch zu einem späteren Zeitpunkt jederzeit das Cmdlet New-CsUCPhoneConfiguration aufrufen, um eine Auflistung von Einstellungen zu erstellen, die auf Standortebene angewendet werden. Somit können Sie die UC-Telefonverwaltung an die jeweiligen Anforderungen der einzelnen Standorte anpassen.

Die mit dem Cmdlet New-CsUCPhoneConfiguration erstellten Einstellungen können später mit dem Cmdlet Remove-CsUCPhoneConfiguration entfernt werden. Auch wenn Sie die Einstellungen für einen Standort entfernen, werden die Lync 2010-Telefone an diesem Standort weiterhin verwaltet; für diese Telefone gelten damit jedoch automatisch die globalen Einstellungen.

Sie können das Cmdlet Remove-CsUCPhoneConfiguration auch für globale Einstellungen ausführen. In diesem Fall werden die globalen Einstellungen jedoch nicht wirklich entfernt. Globale UC-Telefoneinstellungen können nicht entfernt werden. Stattdessen werden alle Eigenschaften in den globalen Einstellungen auf die Standardwerte zurückgesetzt. Wenn Sie beispielsweise das Zeitintervall für eine Telefonsperrung in 30 Minuten geändert haben, wird durch "Entfernen" der globalen Einstellungen das Intervall auf den Standardwert 10 Minuten zurückgesetzt.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Remove-CsUCPhoneConfiguration 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 "Remove-CsUCPhoneConfiguration"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Eindeutige ID der Auflistung von zu entfernenden Konfigurationseinstellungen für UC-Telefone. Verwenden Sie eine Syntax wie die folgende, um eine Standortauflistung zu entfernen: -Identity "site:Redmond". Verwenden Sie folgende Syntax, um die globale Auflistung zu entfernen (zurückzusetzen): -Identity global. Beachten Sie, dass Sie beim Festlegen eines Richtlinienidentitätswerts keine Platzhalter verwenden können.

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.WritableConfig.Policy.Voice.UcPhoneSettings-Objekt. Remove-CsUCPhoneConfiguration akzeptiert weitergeleitete Objektinstanzen für UC-Telefoneinstellungen.

Rückgabetypen

Keine. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Policy.Voice.UcPhoneSettings" entfernt.

Beispiel

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

Remove-CsUCPhoneConfiguration -Identity site:Redmond

Der Befehl in Beispiel 1 entfernt die Konfigurationseinstellungen des UC-Telefons am Standort "Redmond" (-Identity site:Redmond). Wenn die Einstellungen auf Standortebene entfernt werden, gelten für die UC-Telefone der Benutzer an diesem Standort die globalen Telefonkonfigurationseinstellungen.

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

Get-CsUCPhoneConfiguration -Filter site:* | Remove-CsUCPhoneConfiguration

In Beispiel 2 werden alle UC-Telefoneinstellungen entfernt, die auf Standortebene konfiguriert wurden. Hierzu verwendet der Befehl zunächst Get-CsUCPhoneConfiguration und den Parameter "Filter", um alle auf Standortebene konfigurierten Einstellungen zurückzugeben. Mit dem Filterwert "site:*" werden die zurückgegebenen Daten auf Einstellungen beschränkt, bei denen der Wert der Eigenschaft "Identity" mit der Zeichenfolge "site:" beginnt. (Dies ist die einzige Eigenschaft, nach der Sie filtern können.) Diese gefilterte Auflistung wird anschließend an das Cmdlet Remove-CsUCPhoneConfiguration weitergeleitet, um sämtliche Elemente in der Auflistung zu entfernen.

-------------------------- Beispiel 3 --------------------------

Get-CsUCPhoneConfiguration | Where-Object {$_.EnforcePhoneLock -eq $False} | Remove-CsUCPhoneConfiguration

In Beispiel 3 werden alle UC-Telefoneinstellungen entfernt, mit denen keine Telefonsperrung erzwungen wird. Hierzu verwendet der Befehl zunächst Get-CsUCPhoneConfiguration ohne Parameter, um eine Auflistung aller UC-Telefoneinstellungen zurückzugeben, die derzeit in der Organisation verwendet werden. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, bei denen die Eigenschaft "EnforceLockProperty" den Wert "False" aufweist. Diese gefilterte Auflistung wird dann an das Cmdlet Remove-CsUCPhoneConfiguration weitergeleitet, das alle Elemente in der Auflistung entfernt.

-------------------------- Beispiel 4 --------------------------

Get-CsUCPhoneConfiguration | Where-Object {$_.SIPSecurityMode -ne "High"} | Remove-CsUCPhoneConfiguration

Mit dem vorstehenden Befehl werden alle Konfigurationseinstellungen für UC-Telefone gelöscht, bei denen der SIP-Sicherheitsmodus den Wert "Low" oder "Medium" aufweist. Hierzu wird zunächst Get-CsUCPhoneConfiguration aufgerufen, um eine Auflistung aller UC-Telefoneinstellungen zurückzugeben, die für die Verwendung in der Organisation konfiguriert sind. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur die Einstellungen herausfiltert, bei denen die Eigenschaft "SIPSecurityMode" den Wert "Low" oder "Medium" aufweist. Dazu werden die Einstellungen ausgewählt, bei denen "SIPSecurityMode" nicht den Wert "High" aufweist. (Es gibt drei mögliche Werte für "SIPSecurityMode": "Low", "Medium" und "High".) Die gefilterte Auflistung wird dann an das Cmdlet Remove-CsUCPhoneConfiguration weitergeleitet, das alle Einstellungen löscht, bei denen "SIPSecurityMode" nicht den Wert "High" aufweist.