Freigeben über

  • Artikel

Set-CsUnassignedNumber

 

Letztes Änderungsdatum des Themas: 2012-03-26

Ändert einen vorhandenen Bereich von nicht zugewiesenen Nummern sowie die Routingregeln, die auf diese Nummern angewendet werden.

Syntax

Set-CsUnassignedNumber [-Identity <XdsGlobalRelativeIdentity>] [-NumberRangeStart <String>] [-NumberRangeEnd <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]

Set-CsUnassignedNumber [-Identity <XdsGlobalRelativeIdentity>] [-NumberRangeStart <String>] [-NumberRangeEnd <String>] -ExUmAutoAttendantPhoneNumber <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]

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

Set-CsUnassignedNumber [-Identity <XdsGlobalRelativeIdentity>] [-NumberRangeStart <String>] [-NumberRangeEnd <String>] -AnnouncementService <String> -AnnouncementName <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]

Set-CsUnassignedNumber [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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. Mit diesem Cmdlet werden die Einstellungen geändert, die dieses Routing definieren.

Um einige der Einstellungen für dieses Cmdlet zu ändern, müssen Sie entweder Ansagen für Ihr System definieren oder eine automatische Exchange Unified Messaging (UM)-Telefonzentrale einrichten. Um zu ermitteln, ob Ansagen definiert wurden, rufen Sie das Cmdlet Get-CsAnnouncement auf. Verwenden Sie New-CsAnnouncement, um eine neue Ansage 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 Set-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 "Set-CsUnassignedNumber"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

Zeichenfolge

Der eindeutige Name für den Bereich nicht zugewiesener Nummern, der geändert wird.

Instance

Optional

DisplayAnnouncementVacantNumberRange

Ein Verweis auf ein Objekt, das Einstellungen für nicht zugewiesene Nummern enthält. Dieses Objekt muss ein Objekt vom Typ "Microsoft.Rtc.Management.Voice.Helpers.DisplayAnnouncementVacantNumberRange" sein und kann mit dem Cmdlet Get-CsUnassignedNumber abgerufen werden.

AnnouncementName

Erforderlich

Zeichenfolge

Der Name der Ansage, die zur Verarbeitung von Anrufen bei Nummern in diesem Bereich verwendet wird.

AnnouncementService

Erforderlich

Zeichenfolge

Der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) oder die Dienst-ID des Ansageservers.

ExUmAutoAttendantPhoneNumber

Erforderlich

Zeichenfolge

Die Telefonnummer der automatischen Exchange UM-Telefonzentrale, an die Anrufe für Nummern in diesem Bereich weitergeleitet werden. Der Kontakt für die automatische Exchange UM-Telefonzentrale muss bereits eingerichtet sein, um diesem Parameter einen Wert zuweisen zu können.

NumberRangeStart

Optional

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

Optional

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.

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.Voice.Helpers.DisplayAnnouncementVacantNumberRange-Objekt. Akzeptiert eine weitergeleitete Eingabe von Objekten für nicht zugewiesene Nummern.

Rückgabetypen

Dieses Cmdlet gibt keinen Wert zurück. Mit ihm wird ein Objekt vom Typ "Microsoft.Rtc.Management.Voice.Helpers.DisplayAnnouncementVacantNumberRange" geändert.

Beispiel

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

Set-CsUnassignedNumber -Identity UNSet1 -NumberRangeStart "+14255551000" -NumberRangeEnd "+14255551900"

In diesem Beispiel wird ein Bereich nicht zugewiesener Nummern mit dem Namen "UNSet1" geändert. Zuerst wird der Wert "UNSet1" an den Parameter "Identity" übergeben. Dabei handelt es sich um den Namen des Bereichs nicht zugewiesener Nummern, der geändert werden soll. Mit den Parametern "NumberRangeStart" (+14255551000) und "NumberRangeEnd" (+14255551900) wird dann der Bereich nicht zugewiesener Nummern geändert, auf den die festgelegte Ansage oder die automatische Telefonzentrale angewendet wird.

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

Get-CsUnassignedNumber | Where-Object {$_.AnnouncementName -match "Welcome"} | Set-CsUnassignedNumber -AnnouncementService ApplicationServer:redmond.litwareinc.com -AnnouncementName "Help Desk Announcement"

In diesem Beispiel wird die Ansage aller Einstellungen für den Bereich nicht zugewiesener Nummern geändert, bei denen der Name einer Ansage die Zeichenfolge "Welcome" enthält. Zunächst wird Get-CsUnassignedNumber aufgerufen, um alle Einstellungen für nicht zugewiesene Nummern abzurufen. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Auflistung auf die Einstellungen beschränkt, bei denen die Eigenschaft "AnnouncementName" die Zeichenfolge "Welcome" enthält (der Vergleichsoperator "-match" steht für "matches"). Anschließend werden diese Einstellungen an das Cmdlet Set-CsUnassignedNumber weitergeleitet, wobei mit dem Parameter "AnnouncementService" die Anwendungsserver-ID des Ansagediensts (ApplicationServer:redmond.litwareinc.com) und mit dem Parameter "AnnouncementName" der Name der neuen Ansage (Help Desk Announcement) geändert wird. Beachten Sie, dass Sie nach wie vor neben dem Namen auch die Dienst-ID angeben müssen, auch wenn sich nur der Name ändert, die Dienst-ID aber gleich bleibt.