Share via

  • Artikel

New-CsExUmContact

 

Letztes Änderungsdatum des Themas: 2012-03-25

Erstellt ein neues Kontaktobjekt für eine automatische Telefonzentrale oder den Teilnehmerzugriff für den gehosteten Exchange Unified Messaging (UM)-Dienst.

Syntax

New-CsExUmContact -DisplayNumber <String> -OU <OUIdParameter> -RegistrarPool <Fqdn> -SipAddress <String> [-AutoAttendant <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Microsoft Lync Server 2010 wird mit Exchange UM eingesetzt, um verschiedene VoIP-bezogene Funktionen wie automatische Telefonzentralen oder den Teilnehmerzugriff bereitzustellen. Wenn Exchange UM nicht als lokaler, sondern als gehosteter Dienst bereitgestellt wird, müssen zum Verwenden einer automatischen Telefonzentrale und des Teilnehmerzugriffs mit diesem Cmdlet Kontaktobjekte erstellt werden. Zum Erstellen dieser Objekte wird das Cmdlet New-CsExUmContact aufgerufen.

Ein mit diesem Cmdlet erstelltes Kontaktobjekt wird innerhalb des Systems erst verfügbar, wenn eine gehostete Voicemailrichtlinie zur Konfiguration von Routingeinstellungen für den Kontakt angewendet wurde. Gehostete Voicemailrichtlinien können über das Cmdlet Get-CsHostedVoicemailPolicy abgerufen werden. Anhand der abgerufenen Richtlinien lässt sich ermitteln, ob eine geeignete Richtlinie auf globaler oder Standortebene bzw. eine Richtlinie auf Benutzerbasis vorhanden ist, die diesem Kontakt zugewiesen werden muss.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet New-CsExUmContact lokal auszuführen: RTCUniversalUserAdmins. 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-CsExUmContact"}

Parameter

Parameter Erforderlich Typ Beschreibung

SipAddress

Erforderlich

Zeichenfolge

Die SIP-Adresse des Kontakts. Dabei muss es sich um eine neue Adresse handeln, die noch nicht als Benutzer oder Kontakt in Active Directory-Domänendienste (AD DS) vorhanden ist. Dieser Wert muss mit der Zeichenfolge "sip:" beginnen, gefolgt von der SIP-Adresse.

RegistrarPool

Erforderlich

FQDN

Der vollqualifizierte Domänenname (FQDN) des Pools, in dem der Registrierungsdienst ausgeführt wird.

Beachten Sie, dass Exchange UM-Kontakte in Lync Server 2010 nicht in Pools verschoben werden können, die Teil von Microsoft Office Communications Server 2007- oder Microsoft Office Communications Server 2007 R2-Bereitstellungen sind.

Vollständiger Datentyp: Microsoft.Rtc.Management.Deploy.Fqdn

DisplayNumber

Erforderlich

Zeichenfolge

Die Telefonnummer des Kontakts. Die Anzeigenummern für jeden Kontakt müssen eindeutig sein (es ist beispielsweise nicht zulässig, dass zwei Exchange UM-Kontakte über dieselbe Anzeigenummer verfügen).

Dieser Wert kann mit einem Pluszeichen (+) beginnen und eine beliebige Anzahl von Ziffern umfassen. Die erste Ziffer darf keine Null sein.

OU

Erforderlich

OUIdParameter

Die Organisationseinheit (OU), in der dieser Kontakt in Active Directory platziert wird.

Vollständiger Datentyp: Microsoft.Rtc.Management.AD.OUIdParameter

AutoAttendant

Optional

Boolescher Wert

Gibt an, ob es sich bei diesem Kontaktobjekt um eine automatische Telefonzentrale handelt. (Eine automatische Telefonzentrale stellt eine Reihe von Ansagen bereit, über die Anrufer innerhalb des Telefonsystems navigieren und den gewünschten Gesprächspartner erreichen können.)

Standard: False

Description

Optional

Zeichenfolge

Eine Beschreibung dieses Kontakts. Anhand der Beschreibung können Administratoren den Typ des Kontakts (automatische Telefonzentrale oder Teilnehmerzugriff), den Standort, den Anbieter sowie andere Informationen ermitteln, die Aufschluss über den Zweck der einzelnen Exchange UM-Kontakte geben.

PassThru

Optional

Switch-Parameter

Gibt die Ergebnisse dieses Befehls zurück. Bei Ausführung dieses Cmdlets wird das neu erstellte Objekt angezeigt. Da diese Ausgabe wiederholt wird, wenn dieser Parameter aufgenommen wird, ist die Verwendung des Parameters redundant.

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.

Rückgabetypen

Erstellt ein Objekt vom Typ "Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact".

Beispiel

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

New-CsExUmContact -SipAddress sip:exumsa1@fabrikam.com -RegistrarPool RedmondPool.litwareinc.com -OU "OU=ExUmContacts,DC=litwareinc,DC=com" -DisplayNumber 2065554567

In diesem Beispiel wird das Cmdlet New-CsExUmContact aufgerufen, um ein neues Exchange UM-Kontakt in Active Directory zu erstellen. Zum Erstellen eines neuen Kontakts muss die SIP-Adresse (in diesem Beispiel "sip:exumsa1@fabrikam.com") der automatischen Telefonzentrale oder des Teilnehmerzugriffs angegeben werden. Ferner müssen folgende Informationen angegeben werden: der Name des Pools, in dem der Lync Server 2010-Registrierungsdienst ausgeführt wird (RedmondPool.litwareinc.com), die OU, in der diese Informationen gespeichert werden (OU=ExUmContacts,DC=litwareinc,DC=com), und die Telefonnummer der automatischen Telefonzentrale oder des Teilnehmerzugriffs (2065554567). Da der Parameter "AutoAttendant" nicht eigens angegeben wurde, wird der Standardwert "False" angewendet, und es wird angenommen, dass es sich bei diesem Kontaktobjekt um einen Kontakt für den Teilnehmerzugriff handelt.

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

New-CsExUmContact -SipAddress sip:exumaa1@fabrikam.com -RegistrarPool RedmondPool.litwareinc.com -OU "OU=ExUmContacts,DC=litwareinc,DC=com" -DisplayNumber 2065559876 -AutoAttendant $True

Dieses Beispiel ist insofern mit Beispiel 1 vergleichbar, als das Cmdlet New-CsExUmContact zum Erstellen eines neuen Exchange UM-Kontakts aufgerufen wird. Erneut wird eine neue automatische Telefonzentrale bzw. ein neuer Teilnehmerzugriffskontakt erstellt, diesmal mit der SIP-Adresse "sip:exumaa1@fabrikam.com". Anschließend werden folgende Informationen angegeben: der Name des Pools, in dem der Lync Server 2010-Registrierungsdienst ausgeführt wird (RedmondPool.litwareinc.com), die OU, in der diese Informationen gespeichert werden (OU=ExUmContacts,DC=litwareinc,DC=com), und die Telefonnummer der automatischen Telefonzentrale bzw. des Teilnehmerzugriffs (2065554567). Der Unterschied ist, dass in diesem Beispiel für den optionalen Parameter "AutoAttendant" der Wert "True" ($True) festgelegt wird, um anzuzeigen, dass es sich bei diesem Objekt tatsächlich um eine automatische Telefonzentrale handelt.