• Artikel

New-CsCommonAreaPhone

 

Letztes Änderungsdatum des Themas: 2012-03-23

Erstellt ein neues Telefon in einem öffentlichen Bereich, das über Microsoft Lync Server 2010 verwaltet werden kann. 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

New-CsCommonAreaPhone -LineUri <String> -OU <OUIdParameter> -RegistrarPool <Fqdn> [-Confirm [<SwitchParameter>]] [-Description <String>] [-DisplayName <String>] [-DisplayNumber <String>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]

New-CsCommonAreaPhone -DN <ADObjectId> -LineUri <String> -RegistrarPool <Fqdn> [-Confirm [<SwitchParameter>]] [-Description <String>] [-DisplayName <String>] [-DisplayNumber <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"

Wie bereits erwähnt, können neue Telefone in öffentlichen Bereiche mit dem Cmdlet New-CsCommonAreaPhone erstellt werden. Mit New-CsCommonAreaPhone können Sie entweder neue Kontaktobjekte für Telefone in öffentlichen Bereichen erstellen oder bestehende Kontaktobjekte einem neuen Telefon in einem öffentlichen Bereich zuweisen. Weitere Informationen finden Sie weiter unten in diesem Thema in den Beschreibungen zu den Parametern "OU" und "DN".

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

Parameter

Parameter Erforderlich Typ Beschreibung

LineUri

Erforderlich

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 am Ende des Anschluss-URI hinzugefügt. Beispiel: TEL:+14255551297; ext=51297.

RegistrarPool

Erforderlich

Zeichenfolge

Vollqualifizierter Domänenname (FQDN) des Registrierungspools, in dem sich das Kontaktobjekt befindet. Beispiel: -RegistrarPool "atl-cs-001.litwareinc.com".

Description

Optional

Zeichenfolge

Ermöglicht es Ihnen, das Active Directory-Attribut "Description" für ein Telefon in einem öffentlichen Bereich festzulegen. Dies bietet Ihnen wiederum 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 in einem öffentlichen Bereich festzulegen.

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.

DN

Optional

Active Directory-DN (Distinguished Name)

Ermöglicht es Ihnen, dem neuen Telefon im öffentlichen Bereich ein bestehendes Active Directory-Kontaktobjekt zuzuordnen. Wenn Sie einem Telefon in einem öffentlichen Bereich ein Kontaktobjekt zuweisen möchten, verwenden Sie den Parameter "DN", gefolgt vom Distinguished Name dieses Kontakts. Beispiel: -DN "cn=Building 14 Lobby,dc=litwareinc,dc=com". Beachten Sie, dass beim Ausführen des Befehls ein Fehler auftritt, wenn der angegebene Kontakt nicht vorhanden ist. Der Befehl verursacht auch dann einen Fehler, wenn der angegebene Kontakt bereits für Lync Server aktiviert wurde. In diesem Fall müssen Sie den Kontakt zuerst über Disable-CsUser deaktivieren und anschließend New-CsCommonAreaPhone ausführen.

Der Parameter "DN" ist besonders nützlich in Organisationen, die bereits Kontaktobjekte für Konferenzräume und andere Entitäten erstellt haben. Diese Kontakte werden häufig zur Zeitplanung eingesetzt. Mithilfe des Parameters "DN" können Sie ein neues Telefon im öffentlichen Bereich anhand eines dieser vorhandenen Kontaktobjekte erstellen.

Sie können die Parameter "OU" und "DN" nicht in demselben Befehl verwenden.

OU

Optional

Active Directory-DN (Distinguished Name)

Distinguished Name (DN) der Active Directory-Organisationseinheit (OU), in der sich das Kontaktobjekt befinden soll. Beispiel: -OU "ou=Redmond,dc=litwareinc,dc=com”.

Wenn Sie den Parameter "OU" angeben, wird in der angegebenen Organisationseinheit (OU, Organizational Unit) ein neuer Kontakt erstellt. Dem Kontakt wird automatisch eine GUID (Globally Unique Identifier) als allgemeiner Name zugewiesen. Der Name des Kontaktobjekts könnte dann folgendermaßen aussehen: {ce84964a-c4da-4622-ad34-c54ff3ed361f}.

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. Außerdem muss sie 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

Keine. New-CsCommonAreaPhone akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit New-CsCommonAreaPhone werden neue Instanzen des Objekts "Microsoft.Rtc.Management.ADConnect.Schema.OCSADCommonAreaPhoneContact" erstellt.

Beispiel

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

New-CsCommonAreaPhone -LineUri tel:+14255556710 -RegistrarPool redmond-cs-001.litwareinc.com -DisplayName "Building 14 Lobby" -OU "ou=Telecommunications,dc=litwareinc,dc=com"

Der Befehl in Beispiel 1 erstellt ein neues Telefon im öffentlichen Bereich mit der Telefonnummer 1-425-555-6710. (Beachten Sie, dass "LineUri" im E.164-Format angegeben werden muss.) Mit dem Befehl wird nicht nur die Telefonnummer festgelegt, sondern auch der Registrierungspool (RegistrarPool), der Active Directory-Anzeigename (DisplayName) und der Distinguished Name der OU, für die das jeweilige Kontaktobjekt erstellt werden soll (OU).

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

New-CsCommonAreaPhone -LineUri tel:+14255556710 -RegistrarPool redmond-cs-001.litwareinc.com -DN "cn=Building 14 Lobby,ou=Telecommunications,dc=litwareinc,dc=com"

Der Befehl in Beispiel 2 ist eine Variante des Befehls in Beispiel 1. In Beispiel 2 wird das neue Telefon im öffentlichen Bereich jedoch einem bestehenden Active Directory-Kontaktobjekt zugeordnet. Hierzu nutzt der Befehl den Parameter "DN", nicht den Parameter "OU", und den Distinguished Name des bestehenden Kontaktobjekts (cn=Building 14 Lobby,ou=Telecommunications,dc=litwareinc,dc=com) als Parameterwert. In diesem Befehl wird auch "DisplayName" nicht verwendet, das heißt, das neue Telefon im öffentlichen Bereich verwendet den Anzeigenamen, der dem bestehenden Kontaktobjekt bereits zugewiesen ist.