Freigeben über

  • Artikel

New-CsUnassignedNumber

 

Letztes Änderungsdatum des Themas: 2012-03-26

Erstellt einen neuen Bereich nicht zugewiesener Nummern sowie die Routingregeln, die auf diese Nummern angewendet werden. Durch Ausführung dieses Cmdlets wird der Routingtabelle für nicht zugewiesene Nummern ein Eintrag hinzugefügt.

Syntax

New-CsUnassignedNumber -Identity <XdsGlobalRelativeIdentity> -NumberRangeStart <String> -NumberRangeEnd <String> -AnnouncementService <String> -AnnouncementName <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]

New-CsUnassignedNumber -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]

New-CsUnassignedNumber -Identity <XdsGlobalRelativeIdentity> -NumberRangeStart <String> -NumberRangeEnd <String> -ExUmAutoAttendantPhoneNumber <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Nicht zugewiesene Nummern sind Telefonnummern, die einer Organisation, aber keinen bestimmten Benutzern oder Telefonen zugewiesen sind. Microsoft Lync Server 2010 kann so eingerichtet werden, dass Anrufe an bestimmte Ziele weitergeleitet werden, wenn eine nicht zugewiesene Nummer angerufen wird. Dieses Cmdlet erstellt die Einstellungen zur Definition der Weiterleitung.

Vor der Ausführung dieses Cmdlets müssen Sie entweder Ankündigungen für Ihr System definieren oder eine automatische Telefonzentrale in Exchange Unified Messaging (UM) einrichten. Um zu ermitteln, ob Ankündigungen definiert wurden, rufen Sie das Cmdlet Get-CsAnnouncement auf. Verwenden Sie New-CsAnnouncement, um eine neue Ankündigung zu erstellen. Zum Überprüfen der Einstellungen für eine automatische Exchange UM-Telefonzentrale verwenden Sie das Cmdlet Get-CsExUmContact.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsGlobalRelativeIdentity

Ein eindeutiger Name für den Bereich nicht zugewiesener Nummern, der erstellt wird. Alle Bereiche nicht zugewiesener Nummern sind global gültig, daher muss der hier angegebene Name in der gesamten Lync Server 2010-Bereitstellung eindeutig sein.

AnnouncementName

Erforderlich

Zeichenfolge

Der Name der Ankündigung, die zur Verarbeitung von Anrufen für Nummern in diesem Bereich verwendet wird.

AnnouncementService

Erforderlich

Zeichenfolge

Der vollqualifizierten Domänenname (Fully Qualified Domain Name, FQDN) oder die Dienst-ID des Ankündigungsdiensts. Dieser Parameter ist nur erforderlich, wenn Sie keinen Wert für den Parameter "ExUmAutoAttendantPhoneNumber" festgelegt haben.

ExUmAutoAttendantPhoneNumber

Erforderlich

Zeichenfolge

Die Telefonnummer der automatischen Exchange UM-Telefonzentrale, an die Anrufe für Nummern in diesem Bereich weitergeleitet werden. Dieses Feld ist nur erforderlich, wenn Sie keinen Ankündigungsserver verwenden (und demnach keine Werte für die Parameter "AnnouncementService" oder "AnnouncementName" angeben). Der Kontakt für die automatische Exchange UM-Telefonzentrale muss bereits eingerichtet sein, um diesem Parameter einen Wert zuweisen zu können.

NumberRangeStart

Erforderlich

Zeichenfolge

Die erste Nummer im Bereich der nicht zugewiesenen Nummern. Der Wert muss kleiner oder gleich dem Wert von "NumberRangeEnd" sein.

Der Wert muss mit dem regulären Ausdruck (tel:)?(\+)?[1-9]\d{0,17}(;ext=[1-9]\d{0,9})? übereinstimmen. Dies bedeutet, dass die Nummer mit der Zeichenfolge "tel:" (wenn Sie diese Zeichenfolge nicht angeben, wird sie automatisch hinzugefügt) sowie einem Pluszeichen (+) und einer Zahl zwischen 1 und 9 beginnen kann. Die Telefonnummer kann bis zu 17 Zeichen umfassen, gefolgt von einer Durchwahl im Format ";ext=" plus der Durchwahlnummer.

NumberRangeEnd

Erforderlich

Zeichenfolge

Die letzte Nummer im Bereich der nicht zugewiesenen Nummern. Der Wert muss größer oder gleich dem Wert von "NumberRangeStart" sein. Zur Festlegung eines Bereichs mit nur einer Nummer verwenden Sie für "NumberRangeStart" und "NumberRangeEnd" denselben Wert.

Der Wert muss mit dem regulären Ausdruck (tel:)?(\+)?[1-9]\d{0,17}(;ext=[1-9]\d{0,9})? übereinstimmen. Dies bedeutet, dass die Nummer mit der Zeichenfolge "tel:" (wenn Sie diese Zeichenfolge nicht angeben, wird sie automatisch hinzugefügt) sowie einem Pluszeichen (+) und einer Zahl zwischen 1 und 9 beginnen kann. Die Telefonnummer kann bis zu 17 Zeichen umfassen, gefolgt von einer Durchwahl im Format ";ext=" plus der Durchwahlnummer.

Priority

Optional

Int32

Bereiche nicht zugewiesener Nummern können sich überschneiden. Wenn eine Nummer in mehr als einen Bereich fällt, wird der Bereich mit der höheren Priorität verwendet.

Force

Optional

Switch-Parameter

Unterdrückt alle Bestätigungsaufforderungen, die andernfalls vor der Durchführung von Änderungen angezeigt würden.

InMemory

Optional

Switch-Parameter

Erstellt einen Objektverweis ohne einen Commit für das Objekt auszuführen und die Änderungen dadurch dauerhaft zu speichern. Wenn Sie die Ausgabe des mit diesem Parameter aufgerufenen Cmdlet einer Variablen zuweisen, können Sie die Eigenschaften des Objektverweises ändern und anschließend einen Commit für diese Änderungen ausführen, indem Sie das entsprechende Cmdlet vom Typ "Set-" aufrufen.

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.Voice.Helpers.DisplayAnnouncementVacantNumberRange".

Beispiel

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

New-CsUnassignedNumber -Identity UNSet1 -NumberRangeStart "+14255551000" -NumberRangeEnd "+14255551100" -AnnouncementService ApplicationServer:redmond.litwareinc.com -AnnouncementName "Welcome Announcement"

In diesem Beispiel wird ein Bereich nicht zugewiesener Nummern mit dem Namen "UNSet1" erstellt. Mit den Parametern "NumberRangeStart" (+14255551000) und "NumberRangeEnd" (+14255551100) wird der Bereich nicht zugewiesener Nummern definiert, auf den die festgelegte Ankündigung angewendet wird. Abschließend wird die Ankündigung festgelegt, indem zunächst über den Parameter "AnnouncementService" die Dienst-ID des Ankündigungsdiensts bereitgestellt und dann der Wert "Welcome Announcement" an den Parameter "AnnouncementName" übergeben wird. Beachten Sie, dass im System bereits eine Ankündigung mit diesem Namen vorhanden sein muss.

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

New-CsUnassignedNumber -Identity UNSet2 -NumberRangeStart "+14255552100" -NumberRangeEnd "+14255552200" -ExUmAutoAttendantPhoneNumber "+12065551234"

In diesem Beispiel wird ein Bereich nicht zugewiesener Nummern mit dem Namen "UNSet2" erstellt. Wie in Beispiel 1 wird mit den Parametern "NumberRangeStart" (+14255552100) und "NumberRangeEnd" (+14255552200) der Bereich nicht belegter Nummern definiert, auf den die festgelegte Ankündigung angewendet wird. In diesem Beispiel wird für den Nummernbereich jedoch anstelle des Ankündigungsdiensts die automatische Exchange UM-Telefonzentrale verwendet. (Die automatische Telefonzentrale ist eine einzelne Rufnummer, die als Hauptnummer für die Organisation dient und eine Reihe von Ansagen bereitstellt, über die Anrufer den gewünschten Gesprächspartner erreichen können.) Abschließend wird eine Telefonnummer an den Parameter "ExUmAutoAttendantPhoneNumber" übergeben. Beachten Sie, dass Exchange UM eingerichtet sein muss und dass es sich bei dieser Nummer um eine Telefonnummer für ein vorhandenes Kontaktobjekt in Active Directory-Domänendienste (AD DS) handeln muss. Der Kontakt muss ein Kontakt für die automatische Telefonzentrale sein, d. h. die Eigenschaft "AutoAttendant" des Kontakts muss den Wert "True" aufweisen.

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

New-CsUnassignedNumber -Identity UNSet2 -NumberRangeStart "+14255552100" -NumberRangeEnd "+14255552200" -ExUmAutoAttendantPhoneNumber "+12065551234" -Priority 2

Beispiel 3 ist mit Beispiel 2 fast identisch: Es wird ein Bereich nicht zugewiesener Nummern mit dem Namen "UNSet2" erstellt. Der Unterschied liegt darin, dass der Parameter "Priority" hinzugefügt wurde, in diesem Fall mit dem Wert 2. Wenn ein weiterer Bereich nicht zugewiesener Nummern definiert wurde, der sich mit dem Bereich überschneidet, und dieser Bereich eine höhere Priorität (einen niedrigeren Parameterwert, z. B. 1) aufweist, werden Anrufe basierend auf den Einstellungen für den Bereich mit der höheren Priorität weitergeleitet.