Remove-CsUnassignedNumber

 

Letztes Änderungsdatum des Themas: 2012-03-26

Entfernt einen bestehenden Bereich von nicht zugewiesenen Nummern sowie die Routingregeln, die auf diese Nummern angewendet werden.

Syntax

Remove-CsUnassignedNumber -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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 diese Routingeinstellungen entfernt.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsGlobalRelativeIdentity

Der eindeutige Name des Bereichs von nicht zugewiesenen Nummern, den Sie entfernen möchten.

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" entfernt.

Beispiel

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

Remove-CsUnassignedNumber -Identity UNSet1

In diesem Beispiel werden die Einstellungen für nicht zugewiesene Nummern mit dem Identitätswert "UNSet1" entfernt.

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

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

In Beispiel 2 werden alle Einstellungen für nicht zugewiesene Nummern entfernt, bei denen der Name der zugewiesenen Ansage die Zeichenfolge "Welcome" enthält. Der Befehl ruft zunächst das Cmdlet Get-CsUnassignedNumber auf, das eine Auflistung aller Einstellungen für nicht zugewiesene Nummern zurückgibt. Diese Auflistung wird dann an das Cmdlet Where-Object übergeben, das die Auflistung auf die Einstellungen für nicht zugewiesene Nummern beschränkt, deren Parameter "AnnouncementName" die Zeichenfolge "Welcome" enthält (-match). Die gefilterte Auflistung wird schließlich an das Cmdlet Remove-CsUnassignedNumber übergeben, das die verbleibenden Einträge in der Auflistung entfernt.