Freigeben über

  • Artikel

Get-CsUnassignedNumber

 

Letztes Änderungsdatum des Themas: 2012-03-23

Ruft einen oder mehrere Bereiche von nicht zugewiesenen Nummern sowie die Routingregeln ab, die auf diese Nummern angewendet werden.

Syntax

Get-CsUnassignedNumber [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

Get-CsUnassignedNumber [-Filter <String>] [-LocalStore <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 ein oder mehrere Bereiche nicht zugewiesener Nummern abgerufen, die dieses Routing definieren.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Get-CsUnassignedNumber lokal ausführen: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmin. 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 "Get-CsUnassignedNumber"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsGlobalRelativeIdentity

Der eindeutige Name des Bereichs nicht zugewiesener Nummern, der abgerufen werden soll.

Filter

Optional

Zeichenfolge

Führt eine Platzhaltersuche aus, mit der die Ergebnisse auf die Einstellungen für nicht zugewiesene Nummern beschränkt werden können, deren Identitätswerte mit der angegebenen Platzhaltersuchzeichenfolge übereinstimmen.

LocalStore

Optional

Switch-Parameter

Ruft die Informationen zu nicht zugewiesenen Nummern aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Keine.

Rückgabetypen

Gibt ein Objekt vom Typ "Microsoft.Rtc.Management.Voice.Helpers.DisplayAnnouncementVacantNumberRange" zurück.

Beispiel

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

Get-CsUnassignedNumber

In Beispiel 1 wird eine Auflistung aller nicht zugewiesenen Nummern zurückgegeben, die für die Verwendung in Ihrer Organisation konfiguriert wurden.

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

Get-CsUnassignedNumber -Identity UNSet1

In Beispiel 2 wird der Parameter "Identity" verwendet, um die abgerufenen Daten auf die nicht zugewiesenen Nummern zu beschränken, die den Identitätswert "UNSet1" aufweisen. Da Identitätswerte eindeutig sein müssen, wird über diesen Befehl nur der angegebene Bereich nicht zugewiesener Nummern zurückgegeben.

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

Get-CsUnassignedNumber -Filter *Redmond*

In diesem Beispiel wird der Parameter "Filter" verwendet, um eine Auflistung aller Einstellungen für nicht zugewiesene Nummern mit den Identitätswerten zurückzugeben, die die Zeichenfolge "Redmond" enthalten. Mit diesem Befehl wird beispielsweise eine Einstellung für nicht zugewiesene Nummern mit den Identitätswerten "Redmond Numbers", "Unassigned Redmond Numbers", "UNRedmond" usw. zurückgegeben.

-------------------------- Beispiel 4 --------------------------

Get-CsUnassignedNumber | Where-Object {$_.AnnouncementName -match "Welcome"}

In Beispiel 4 werden Get-CsUnassignedNumber und Where-Object verwendet, um eine Auflistung aller Einstellungen für nicht zugewiesene Nummern abzurufen, die den Begriff "Welcome" im Ansagenamen enthalten. Hierzu verwendet der Befehl zunächst Get-CsUnassignedNumber, um alle Einstellungen für nicht zugewiesene Nummern abzurufen. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das einen Filter anwendet, um die zurückgegebenen Daten auf nicht zugewiesene Nummern mit dem Wort "Welcome" in der zugewiesenen Ansage zu beschränken.