• Artikel

Set-CsCommonAreaPhone

 

Letztes Änderungsdatum des Themas: 2012-03-27

Ändert die Eigenschaftswerte eines Telefons im öffentlichen Bereich, das mit Microsoft Lync Server 2010 verwaltet wird. Telefone in öffentlichen Bereichen sind Telefone in Eingangsbereichen von Gebäuden, Aufenthaltsräumen für Mitarbeiter oder in anderen Bereichen, in denen sie oftmals von vielen Menschen und für unterschiedliche Benutzer genutzt werden.

Syntax

Set-CsCommonAreaPhone -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-Description <String>] [-DisplayName <String>] [-DisplayNumber <String>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-EnterpriseVoiceEnabled <$true | $false>] [-LineURI <String>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Telefone in öffentlichen Bereichen sind IP-Telefone, die keinem einzelnen Benutzer zugeordnet sind. Sie befinden sich nicht in einem Büro, sondern normalerweise in Eingangsbereichen, Cafeterias, Aufenthaltsräumen für Mitarbeiter, Besprechungszimmern und anderen Bereichen, in denen viele Menschen zusammenkommen. Die Verwaltung solcher Telefone stellt für Administratoren eine Herausforderung dar, da die Telefonnutzung in Lync Server 2010 normalerweise anhand verschiedener VoIP-Richtlinien und Wähleinstellungen verwaltet wird, die einzelnen Benutzern zugewiesen sind. Telefonen in öffentlichen Bereichen sind keine einzelnen Benutzer zugewiesen.

Eine Methode zur Bewältigung dieser Herausforderung besteht darin, Active Directory-Kontaktobjekte für alle Telefone in öffentlichen Bereichen zu erstellen. (Diese Kontaktobjekte können mit dem Cmdlet New-CsCommonAreaPhone erstellt werden.) Diesen Kontaktobjekten können dann genau wie Benutzerkonten Richtlinien und VoIP-Einstellungen zugewiesen werden. Auf diese Weise können Sie Telefone in öffentlichen Bereichen verwalten, auch wenn sie keinem einzelnen Benutzer zugeordnet sind. Wenn Benutzer beispielsweise nicht die Möglichkeit haben sollen, Anrufe von einem Telefon im öffentlichen Bereich aus weiterzuleiten oder zu parken, können Sie eine VoIP-Richtlinie erstellen, die die Weiterleitung und das Parken von Anrufen verhindert. Weisen Sie diese Richtlinie dann dem Telefon im öffentlichen Bereich zu. (Genauer gesagt, weisen Sie diese Richtlinie dem Kontaktobjekt zu, das für das Telefon im öffentlichen Bereich steht.) Mit dem folgenden Befehl wird allen Telefonen in öffentlichen Bereichen die VoIP-Richtlinie "CommonAreaPhoneVoicePolicy" zugewiesen:

Get-CsCommonAreaPhone | Grant-CsVoicePolicy –PolicyName "CommonAreaPhoneVoicePolicy"

Mit dem Cmdlet Set-CsCommonAreaPhone können Sie die Eigenschaften der Kontaktobjekte ändern, die Telefonen in öffentlichen Bereichen zugeordnet sind. Sie können unter anderem den Active Directory-Anzeigenamen des Kontakts oder den Anschluss-URI (Uniform Resource Identifier) ändern, der dem Telefon zugeordnet ist. Sie können auch den Parameter "Enabled" verwenden, um das Konto für die Verwendung mit Lync Server 2010 zu aktivieren und zu deaktivieren.

Darüber hinaus können Sie mit den Cmdlets vom Typ "CsClientPolicy" das "Hotdesking" für Telefone für gemeinsame Bereiche konfigurieren. Bei einem sog. Hotdesk-Telefon können sich Benutzer über ihre Lync Server-Anmeldeinformationen beim Telefon anmelden. Dadurch erhalten die Benutzer u. a. einen einfachen Zugriff auf ihre Kontakte. Weitere Informationen finden Sie im Hilfethema zum Cmdlet Set-CsClientPolicy.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Set-CsCommonAreaPhone lokal ausführen: RTCUniversalUserAdmins. Berechtigungen zum Ausführen dieses Cmdlets für bestimmte Standorte oder spezifische Active Directory-Organisationseinheiten (OUs) können mit dem Cmdlet Grant-CsOUPermission zugewiesen werden. 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-CsCommonAreaPhone"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

Benutzer-ID

Eindeutige ID des Telefons im öffentlichen Bereich. Telefone in öffentlichen Bereichen werden mit dem Distinguished Name des zugeordneten Kontaktobjekts in Active Directory identifiziert. Telefone in öffentlichen Bereichen verwenden standardmäßig eine GUID (Globally Unique Identifier) als allgemeinen Namen. Telefone weisen daher in der Regel etwa den folgenden Identitätswert auf: CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com. Daher ist es möglicherweise einfacher, Telefone in öffentlichen Bereichen mit dem Cmdlet Get-CsCommonAreaPhone abzurufen und dann die zurückgegebenen Objekte an das Cmdlet Set-CsCommonAreaPhone weiterzuleiten.

Enabled

Optional

Zeichenfolge

Gibt an, ob das Kontaktobjekt für das Telefon im öffentlichen Bereich für Lync Server 2010 aktiviert wurde.

Wenn Sie einen Kontakt mithilfe des Parameters "Enabled" deaktivieren, werden die diesem Konto zugeordneten Informationen beibehalten (einschließlich der zugewiesenen Richtlinien sowie der Information, ob der Benutzer Enterprise-VoIP, die Remoteanrufsteuerung und/oder die Voicemailintegration nutzen darf). Wird das Konto zu einem späteren Zeitpunkt über den Parameter "Enabled" wieder aktiviert, werden die zugeordneten Kontoinformationen wiederhergestellt.

Description

Optional

Zeichenfolge

Ermöglicht es Ihnen, das Active Directory-Beschreibungsattribut für ein Telefon im öffentlichen Bereich zu ändern. Dies bietet Ihnen die Möglichkeit, zusätzliche Informationen zum Telefon bereitzustellen. So können Sie beispielsweise Angaben darüber machen, wer bei Problemen mit dem Telefon kontaktiert werden soll.

DisplayName

Optional

Zeichenfolge

Ermöglicht es Ihnen, den Active Directory-Anzeigenamen des Telefons im öffentlichen Bereich zu ändern.

DisplayNumber

Optional

Zeichenfolge

Die in Microsoft Lync 2010 angezeigte Telefonnummer. Die Eigenschaft "DisplayNumber" kann nach Belieben formatiert werden, z. B. 1-800-555-1234, 1-(800)-555-1234 oder 1.800.555.1234. Beachten Sie bei der Wahl einer Anzeigenummer, dass diese Nummer nur dann auf dem Anzeigebildschirm des Telefons im öffentlichen Bereich angezeigt wird, wenn sie normalisiert werden kann. (Normalisierung ist das Verfahren zum Übersetzen von Nummernzeichenfolgen in ein standardmäßiges Telefonnummernformat.) Wenn für das Telefonnummernformat, das beim Konfigurieren der Anzeigenummer verwendet wird, keine Normalisierungsregel vorhanden ist, zeigt der Anzeigebildschirm des Telefons im öffentlichen Bereich den Wert der Eigenschaft "LineUri" anstelle des Werts der Eigenschaft "DisplayNumber" an.

DomainController

Optional

Zeichenfolge

Ermöglicht es Ihnen, zum Ändern von Kontaktinformationen eine Verbindung mit dem angegebenen Domänencontroller herzustellen. Zum Herstellen einer Verbindung mit einem bestimmten Domänencontroller nehmen Sie den Parameter "DomainController" auf und geben anschließend den Computernamen (z. B. "atl-mcs-001") oder den vollqualifizierten Domänennamen (z. B. "atl-mcs-001.litwareinc.com") an.

EnterpriseVoiceEnabled

Optional

Boolescher Wert

Gibt an, ob das Kontaktobjekt für das Telefon im öffentlichen Bereich für Enterprise-VoIP aktiviert wurde, die von Microsoft angebotene VoIP-Lösung (Voice over Internet Protocol). Mit Enterprise-VoIP können Benutzer Anrufe über das Internet tätigen und müssen nicht länger das herkömmliche Telefonnetz nutzen.

LineUri

Optional

Zeichenfolge

Telefonnummer des Telefons im öffentlichen Bereich. Der Anschluss-URI (Uniform Resource Identifier) muss im E.164-Format angegeben werden und mit dem Präfix "TEL:" beginnen. Beispiel: TEL:+14255551297. Durchwahlnummern werden an das Ende des Anschluss-URI angehängt. Beispiel: TEL:+14255551297; ext=51297.

SipAddress

Optional

SIP-Adresse

Eindeutige ID, mit der das Telefon im öffentlichen Bereich mit SIP-Geräten wie Lync 2010 kommunizieren kann. Die SIP-Adresse muss mit dem Präfix "sip": beginnen und eine gültige SIP-Domäne enthalten. Beispiel: sip:bldg14lobby@litwareinc.com.

PassThru

Optional

Switch-Parameter

Gibt ein Objekt zurück, das das Telefon in einem öffentlichen Bereich darstellt.

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.ADConnect.Schema.OCSADCommonAreaPhoneContact-Objekt.

Rückgabetypen

Set-CsCommonAreaPhone gibt standardmäßig keine Objekte oder Werte zurück. Wenn Sie jedoch den Parameter "PassThru" einschließen, gibt das Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.ADConnect.Schema.OCSADCommonAreaPhoneContact" zurück.

Beispiel

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

Get-CsCommonAreaPhone -Filter {LineUri -eq "tel:+14255556710"} | Set-CsCommonAreaPhone -DisplayName "Employee Lounge"

In Beispiel 1 wird der Active Directory-Anzeigename für das Telefon im öffentlichen Bereich mit der Telefonnummer 1-425-555-6710 geändert. Dazu wird zunächst Get-CsCommonAreaPhone mit dem Parameter "Filter" aufgerufen. Der Filterwert "{LineUri -eq "tel:+14255556710"}" beschränkt die zurückgegebenen Daten auf das Telefon im öffentlichen Bereich, bei dem die Eigenschaft "LineUri" den Wert "tel:+14255556710" aufweist. Das zurückgegebene Objekt wird dann an Set-CsCommonAreaPhone weitergeleitet, das den Wert der Eigenschaft "DisplayName" auf "Employee Lounge" festlegt.

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

Get-CsCommonAreaPhone | Set-CsCommonAreaPhone -Enabled $True

Der Befehl in Beispiel 2 aktiviert alle Telefone in öffentlichen Bereichen, die derzeit für die Verwendung in der Organisation konfiguriert sind. Hierzu ruft der Befehl zunächst Get-CsCommonAreaPhone ohne Parameter auf, um eine Auflistung aller Telefone in öffentlichen Bereichen zurückzugeben. Diese Auflistung wird dann an das Cmdlet Set-CsCommonAreaPhone weitergeleitet, das für jedes Element in der Auflistung die Eigenschaft "Enabled" auf "True" festlegt.

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

Get-CsCommonAreaPhone -Filter {Description -eq $Null} | Set-CsCommonAreaPhone -Description "Common area phone"

Mit dem vorstehenden Befehl wird eine allgemeine Beschreibung allen Telefonen in öffentlichen Bereichen hinzugefügt, bei denen der Eigenschaft "Description" kein Wert zugewiesen wurde. Dazu wird Get-CsCommonAreaPhone mit dem Parameter "Filter" aufgerufen. Der Filterwert "{Description -eq $Null}" stellt sicher, dass nur Telefone in öffentlichen Bereichen zurückgegeben werden, deren Eigenschaft "Description" einen Nullwert aufweist. Die gefilterte Auflistung wird dann an das Cmdlet Set-CsCommonAreaPhone weitergeleitet, das für jedes Element in der Auflistung die allgemeine Beschreibung "Common area phone" zuweist.