• Artikel

Set-CsUCPhoneConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-26

Ermöglicht es Ihnen, die Verwaltungsoptionen für Microsoft Lync 2010 Phone Edition zu ändern, darunter der erforderliche Sicherheitsmodus und ob das Telefon nach einem bestimmten inaktiven Zeitraum automatisch gesperrt werden soll.

Syntax

Set-CsUCPhoneConfiguration [-Identity <XdsIdentity>] [-CalendarPollInterval <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnforcePhoneLock <$true | $false>] [-Force <SwitchParameter>] [-LoggingLevel <Off | Low | Medium | High>] [-MinPhonePinLength <Byte>] [-PhoneLockTimeout <TimeSpan>] [-SIPSecurityMode <Low | Medium | High>] [-Voice8021p <Byte>] [-VoiceDiffServTag <Byte>] [-WhatIf [<SwitchParameter>]]

Set-CsUCPhoneConfiguration [-CalendarPollInterval <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnforcePhoneLock <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-LoggingLevel <Off | Low | Medium | High>] [-MinPhonePinLength <Byte>] [-PhoneLockTimeout <TimeSpan>] [-SIPSecurityMode <Low | Medium | High>] [-Voice8021p <Byte>] [-VoiceDiffServTag <Byte>] [-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 2010 kennen.

Mit den "CsUCPhoneConfiguration"-Cmdlets können Sie Lync 2010 Phone Edition-Telefone mit Konfigurationseinstellungen verwalten. 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. Bei der Installation von Lync Server 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.

Neben der Erstellung neuer Auflistungen von UC-Telefoneinstellungen können Sie mithilfe des Cmdlets Set-CsUCPhoneConfiguration auch die Eigenschaftswerte einer bestehenden Auflistung ändern. Beispielsweise ist die Protokollierung für UC-Telefone standardmäßig deaktiviert. Mit Set-CsUCPhoneConfiguration können Sie den Wert der Eigenschaft "LoggingLevel" der globalen Auflistung in "True" ändern und so die Protokollierung auf globaler Ebene aktivieren.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Repräsentiert die einer Auflistung von UC-Telefonkonfigurationseinstellungen zugewiesene eindeutige ID. Verwenden Sie folgende Syntax, um auf die globalen Einstellungen zu verweisen: -Identity global. Verwenden Sie eine Syntax wie die folgende, um auf eine auf Standortebene konfigurierte Auflistung zu verweisen: -Identity site:Redmond. Beachten Sie, dass beim Angeben eines Identitätswerts keine Platzhalterzeichen verwendet werden können.

Bei Auslassung dieses Parameters werden mit Set-CsUCPhoneConfiguration die globalen Einstellungen geändert.

Instance

Optional

Objekt "UcPhoneSettings"

Ermöglicht Ihnen, einen Verweis auf ein Objekt an das Cmdlet zu übergeben, statt individuelle Parameterwerte festzulegen.

CalendarPollInterval

Optional

TimeSpan

Gibt an, wie oft das UC-Gerät Informationen aus Ihrem Microsoft Outlook-Kalender abruft. Der Wert muss im Format Stunden:Minuten:Sekunden angegeben werden. Verwenden Sie beispielsweise folgende Syntax, um für das Zeitintervall 1 Stunde festzulegen (das maximal zulässige Intervall): -CalendarPollInterval "01:00:00". Der Standardwert lautet 3 Minuten (00:03:00).

EnforcePhoneLock

Optional

Boolescher Wert

Bestimmt, ob UC-Telefone nach der durch "PhoneLockTimeout" angegebenen Anzahl von Minuten automatisch gesperrt werden. Der Standardwert lautet "True".

LoggingLevel

Optional

Zeichenfolge

Ermöglicht die Protokollierung auf dem UC-Gerät. Gültige Werte sind: "Off", "Low", "Medium" und "High". Der Standardwert lautet "Off".

MinPhonePinLength

Optional

Byte

Gibt die Mindestzahl von Ziffern an, die für persönliche Identifikationsnummern (PINs) erforderlich sind.

Mindestwert: 4

Höchstwert: 15

Standard: 6

PhoneLockTimeout

Optional

Timespan

Gibt die Dauer (in Minuten) an, die ein UC-Telefon inaktiv sein muss, bevor es automatisch gesperrt wird.

Der Wert muss unter "01:00:00" (1 Stunde) liegen. Der Standardwert lautet "00:10:00" (10 Minuten).

SIPSecurityMode

Optional

SIPSecurityMode

Gibt die Sicherheitsstufe an, die der Server auf SIP-Sitzungen anwendet, die von einem UC-Telefon initiiert wurden.

Gültige Werte sind:

Low (beliebige Autorisierung- oder Transporttypen sind zulässig).

Medium (für die Benutzerauthentifizierung ist NTLM oder Kerberos erforderlich).

High (für die Benutzerauthentifizierung ist NTLM oder Kerberos, für SIP-Verbindungen TLS erforderlich).

Der Standardwert lautet "High".

Voice8021p

Optional

Byte

Gibt den Benutzerprioritätswert (den 802.1p-Wert) für Sprachdatenverkehr in der Lync Server-Bereitstellung an.

Diese Einstellung gilt nur für Netzwerke, in denen Switches und Bridges 802.1p-fähig sind. Der Mindestwert für diese Eigenschaft beträgt 0, der Höchstwert 7. Der Standardwert lautet 0.

VoiceDiffServTag

Optional

Byte

Gibt die Dezimalschreibweise der 6-Bit-DSCP-Prioritätsmarkierung (DiffServ Code Point) an. Diese Markierung definiert das hopbasierte Verhalten von IP-Paketen, die von den von diesem Server verwalteten UC-Telefonen weitergeleitet werden.

Dieser Wert muss 0 bis 63 Sekunden betragen. Der Standardwert lautet 40.

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. Set-CsUCPhoneConfiguration akzeptiert weitergeleitete Objektinstanzen für UC-Telefoneinstellungen.

Rückgabetypen

Set-CsUCPhoneConfiguration gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Policy.Voice.UcPhoneSettings" konfiguriert.

Beispiel

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

Set-CsUCPhoneConfiguration -Identity global -SIPSecurityMode "Medium"

Der Befehl in Beispiel 1 legt den SIP-Sicherheitsmodus der globalen UC-Telefoneinstellungen auf "Medium" fest.

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

Set-CsUCPhoneConfiguration -Identity site:Redmond -PhoneLockTimeout "00:30:00"

Der vorstehende Befehl ändert die für den Standort "Redmond" konfigurierten UC-Telefoneinstellungen. In diesem Fall ist die Eigenschaft "PhoneLockTimeout" auf 30 Minuten eingestellt. Hierzu werden der Parameter "PhoneLockTimeout" und der Parameterwert 00:30:00 (00 Stunden: 30 Minuten: 00 Sekunden) verwendet.

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

Get-CsUCPhoneConfiguration -Filter "site:*" | Set-CsUCPhoneConfiguration -PhoneLockTimeout "00:30:00"

Beispiel 3 ist eine Variante des Befehls in Beispiel 2. Diesmal wird die Eigenschaft "PhoneLockTimeout" allerdings für alle auf Standortebene konfigurierten UC-Telefoneinstellungen geändert. Dazu ruft der Befehl zunächst Get-CsUCPhoneConfiguration auf. Mit dem Parameter "Filter" und dem Filterwert "site:*" werden die zurückgegebenen Daten auf Telefoneinstellungen beschränkt, die auf Standortebene konfiguriert wurden. Diese gefilterte Auflistung wird dann an das Cmdlet Set-CsUCPhoneConfiguration weitergeleitet, das über den Parameter "PhoneLockTimeout" und den Parameterwert "00:30:00" (00 Stunden: 30 Minuten: 00 Sekunden) den Timeoutwert für die Telefonsperre für jedes Element in der Auflistung auf 30 Minuten festlegt.

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

Get-CsUCPhoneConfiguration | Where-Object {$_.SIPSecurityMode -ne "High"} | Set-CsUCPhoneConfiguration -EnforcePhoneLock $True -PhoneLockTimeout "00:30:00"

Der vorstehende Befehl konfiguriert die Eigenschaften "EnforcePhoneLock" und "PhoneLockTimeout" für alle UC-Telefoneinstellungen, für die der SIP-Sicherheitsmodus auf "Low" oder "Medium" festgelegt ist. Hierzu verwendet der Befehl zunächst Get-CsUCPhoneConfiguration, um alle UC-Telefonkonfigurationseinstellungen in der Organisation zurückzugeben. Diese Informationen werden dann an das Cmdlet Where-Object weitergeleitet, das nur solche Einstellungen herausfiltert, bei denen die Eigenschaft "SIPSecurityMode" nicht "High" entspricht. (Da die SIP-Sicherheit nur auf "Low", "Medium" oder "High" eingestellt werden kann, werden mit dieser Klausel alle Einstellungen ausgewählt, bei denen für "SIPSecurityMode" entweder "Low" oder "Medium" festgelegt ist.) Die gefilterte Auflistung wird dann an das Cmdlet Set-CsUCPhoneConfiguration weitergeleitet, das die Einstellungen der Telefonsperre und der Timeouts mit den Parametern "EnforcePhoneLock" und "PhoneLockTimeout" ändert.

-------------------------- Beispiel 5 --------------------------

Get-CsUCPhoneConfiguration | Where-Object {$_.PhoneLockTimeout -lt "00:10:00"} | Set-CsUCPhoneConfiguration -PhoneLockTimeout "00:10:00"

In Beispiel 5 ist der Timeoutwert für die Telefonsperre für alle UC-Telefoneinstellungen, bei denen die Eigenschaft "PhoneLockTimeout" weniger als 10 Minuten ist, auf 10 Minuten festgelegt. (Damit beträgt der Mindestwert für das Timeout für die Telefonsperre in der gesamten Organisation 10 Minuten.) Hierzu gibt der Befehl zunächst durch Verwendung von Get-CsUCPhoneConfiguration eine Auflistung aller derzeit in der Organisation verwendeten UC-Telefoneinstellungen zurück. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur die Einstellungen herausfiltert, deren Eigenschaft "PhoneLockTimeout" unter 10 Minuten (00 Stunden: 10 Minuten: 00 Sekunden) liegt (der der Vergleichsoperator "-lt" steht für "less than"). Die gefilterte Auflistung wird wiederum an das Cmdlet Set-CsUCPhoneConfiguration weitergeleitet, das den Wert "PhoneLockTimeout" für jedes Element in der Auflistung auf 10 Minuten festlegt.