• Artikel

Remove-CsDialInConferencingAccessNumber

 

Letztes Änderungsdatum des Themas: 2012-03-25

Entfernt eine vorhandene Zugriffsnummer für Einwahlkonferenzen. Bei Einwahlkonferenzen können Benutzer mit einem "normalen" Telefon oder einem Mobiltelefon (d. h. einem Gerät im Telefonfestnetz (Public Switched Telephone Network, PSTN)) am Audioteil einer Konferenz teilnehmen.

Syntax

Remove-CsDialInConferencingAccessNumber -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Bei Einwahlkonferenzen können Benutzer jede Art von Telefon verwenden (z. B. ein herkömmliches Festnetztelefon, ein Mobiltelefon oder ein VoIP-Telefon), um am Audioteil einer Konferenz teilzunehmen. So können Benutzer sogar ohne Computer oder Internetverbindung an der Besprechung teilnehmen. Den Benutzern stehen Audiofunktionen in vollem Umfang zur Verfügung: Sie können mit anderen Teilnehmern sprechen und alles hören. Sie können allerdings keine Präsentationen, Videofeeds oder andere visuellen Elemente sehen, die freigegeben wurden.

Damit Benutzer Einwahlkonferenzfunktionen erhalten, müssen Sie Zugriffsnummern für Einwahlkonferenzen erstellen: Dabei handelt es sich um Telefonnummern, die die Benutzer zur Einwahl in eine Besprechung wählen können. Zugriffsnummern für Einwahlkonferenzen werden mit dem Cmdlet New-CsDialInConferencingAccessNumber erstellt. Wenn Sie eine neue Zugriffsnummer für Einwahlkonferenzen erstellen, erstellen Sie in Wirklichkeit ein neues Kontaktobjekt in Active Directory-Domänendienste (AD DS). Dieses Kontaktobjekt wird zur Darstellung der Zugriffsnummer und ihrer Eigenschaften verwendet. Mit dem Cmdlet Remove-CsDialInConferencingAccessNumber können Sie jede beliebige Einwahlkonferenznummer löschen, die mit New-CsDialInConferencingAccessNumber erstellt wurde. Bei der Ausführung des Cmdlets Remove-CsDialInConferencingAccessNumber wird nicht nur die Nummer aus der Auflistung von Zugriffsnummern für Einwahlkonferenzen, sondern auch das Active Directory-Kontaktobjekt gelöscht, das die festgelegte Zugriffsnummer darstellt.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

SIP-Adresse

SIP-Adresse der zu entfernenden Zugriffsnummer für Einwahlkonferenzen (d. h. das Kontaktobjekt, das diese Nummer darstellt). Sie müssen das Präfix "sip:" beim Festlegen des Identitätswerts angeben, z. B. -Identity "sip:RedmondDialIn@litwareinc.com".

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.Xds.AccessNumber-Objekt. Remove-CsDialInConferencingAccessNumber akzeptiert eine weitergeleitete Eingabe von Zugriffsnummernobjekten.

Rückgabetypen

Mit Remove-CsDialInConferencingAccessNumber werden Instanzen des Objekts "Microsoft.Rtc.Management.Xds.AccessNumber" gelöscht.

Beispiel

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

Remove-CsDialInConferencingAccessNumber -Identity sip:RedmondDialIn@litwareinc.com

Der Befehl in Beispiel 1 löscht die Zugriffsnummer für Einwahlkonferenzen mit dem Identitätswert "sip:RedmondDialIn@litwareinc.com".

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

Get-CsDialInConferencingAccessNumber -Filter {LineUri -like "tel:+1800*"} | Remove-CsDialInConferencingAccessNumber

Mit dem vorstehenden Befehl werden alle gebührenfreien Zugriffsnummern für Einwahlkonferenzen gelöscht. In diesem Beispiel sind das alle Nummern, bei denen die Eigenschaft "LineUri" mit "tel:+1800" beginnt. Hierzu verwendet der Befehl Get-CsDialInConferencingAccessNumber und den Parameter "Filter", um eine Auflistung aller gebührenfreien Zugriffsnummern zurückzugeben, die für die Verwendung in der Organisation konfiguriert wurden. Mit dem Filterwert "{LineUri -like "tel:+1800*"}" werden aus allen zurückgegebenen Daten die Nummern herausgefiltert, bei denen die Eigenschaft "LineUri" mit der Zeichenfolge "tel:+1800" beginnt. Diese gefilterte Auflistung wird dann an Remove-CsDialInConferencingAccessNumber weitergeleitet, das jede Nummer in der Auflistung löscht.

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

Get-CsDialInConferencingAccessNumber -Region "Redmond" | Remove-CsDialInConferencingAccessNumber

In Beispiel 3 werden alle Zugriffsnummern für Einwahlkonferenzen für die Region "Redmond" gelöscht. Hierzu werden zunächst Get-CsDialInConferencingAccessNumber und der Parameter "Region" aufgerufen, um eine Auflistung aller Zugriffsnummern für die Region "Redmond" zurückzugeben. (Dies bedeutet, alle Zugriffsnummern, bei denen die Regionenliste "Redmond" enthält.) Diese Auflistung wird dann an das Cmdlet Remove-CsDialInConferencingAccessNumber weitergeleitet, das alle Zugriffsnummern in der Auflistung löscht.

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

Get-CsDialInConferencingAccessNumber -Region $Null | Remove-CsDialInConferencingAccessNumber

In Beispiel 4 werden alle Zugriffsnummern für Einwahlkonferenzen gelöscht, die keiner Region zugeordnet sind. Hierzu wird Get-CsDialInConferencingAccessNumber mit dem Parameter "Region" und dem Parameterwert "$Null" aufgerufen. Anschließend wird eine Auflistung von Zugriffsnummern zurückgegeben, bei denen die Eigenschaft "Regions" keine Werte aufweist. Diese Auflistung wird dann an das Cmdlet Remove-CsDialInConferencingAccessNumber weitergeleitet, das alle Nummern in der Auflistung löscht.

-------------------------- Beispiel 5 ------------------------

Get-CsDialInConferencingAccessNumber | Where-Object {$_.PrimaryLanguage -ne "it-IT"} | Remove-CsDialInConferencingAccessNumber

Der Befehl in Beispiel 5 löscht alle Zugriffsnummern für Einwahlkonferenzen, bei denen die primäre Sprache nicht auf Italienisch festgelegt ist. Hierzu wird zunächst Get-CsDialInConferencingAccessNumber ohne Parameter aufgerufen, um eine Auflistung aller Zugriffsnummern für Einwahlkonferenzen zurückzugeben, die für die Verwendung in der Organisation konfiguriert wurden. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur die Nummern herausfiltert, bei denen die Eigenschaft "PrimaryLanguage" nicht den Wert "it-IT" (Italienisch) aufweist. Diese Auflistung wird schließlich an das Cmdlet Remove-CsDialInConferencingAccessNumber weitergeleitet, das alle Zugriffsnummern in der Auflistung löscht.

-------------------------- Beispiel 6 ------------------------

Get-CsDialInConferencingAccessNumber -Filter {DisplayName -eq "Default Dial-In Access Number"} | Remove-CsDialInConferencingAccessNumber

In Beispiel 6 wird die Zugriffsnummer für Einwahlkonferenzen mit dem Anzeigenamen "Default Dial-In Access Number" gelöscht. Hierzu wird Get-CsDialInConferencingAccessNumber mit dem Parameter "Filter" und dem Filterwert "{DisplayName -eq "Default Dial-In Access Number"}" aufgerufen. Mit diesem Filterwert werden aus allen zurückgegebenen Daten die Zugriffsnummern herausgefiltert, bei denen die Eigenschaft "DisplayName" den Wert "Default Dial-In Access Number" aufweist. Das zurückgegebene Objekt wird dann an das Cmdlet Remove-CsDialInConferencingAccessNumber weitergeleitet, das die entsprechende Zugriffsnummer löscht.