• Artikel

Remove-CsExUmContact

 

Letztes Änderungsdatum des Themas: 2012-03-25

Entfernt eine automatische Telefonzentrale oder ein Kontaktobjekt für den Teilnehmerzugriff für den gehosteten Exchange Unified Messaging (UM)-Dienst.

Syntax

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

Detaillierte Beschreibung

Microsoft Lync Server 2010 wird mit Exchange UM eingesetzt, um verschiedene VoIP-bezogene Funktionen wie automatische Telefonzentralen oder den Teilnehmerzugriff bereitzustellen. Wenn Exchange UM nicht als lokaler, sondern als gehosteter Dienst bereitgestellt wird, müssen zum Verwenden einer automatischen Telefonzentrale und des Teilnehmerzugriffs Kontaktobjekte mit Windows PowerShell erstellt werden. Alle erstellten Objekte können mit dem Cmdlet Remove-CsExUmContact entfernt werden.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Remove-CsExUmContact lokal auszuführen: RTCUniversalUserAdmins. 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-CsExUmContact"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

UserIdParameter

Die eindeutige ID für das Kontaktobjekt, das entfernt werden soll. Kontaktidentitäten können in den folgenden vier Formaten angegeben werden: als 1) SIP-Adresse des Kontakts, 2) Benutzerprinzipalname (User Principal Name, UPN) des Kontakts, 3) Domänen- und Anmeldename des Kontakts (mit dem Format "Domäne\Anmeldename", z. B. "litwareinc\exum1") und 4) Active Directory-Anzeigename des Kontakts (z. B. "Team Auto Attendant").

Vollständiger Datentyp: Microsoft.Rtc.Management.AD.UserIdParameter

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.ADConnect.Schema.OCSADExUmContact-Objekt. Akzeptiert eine weitergeleitete Eingabe von Exchange UM-Kontaktobjekten.

Rückgabetypen

Dieses Cmdlet gibt kein Objekt zurück. Entfernt ein Objekt vom Typ Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact.

Beispiel

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

Remove-CsExUmContact -Identity sip:exumsa1@fabrikam.com

In diesem Beispiel wird der Exchange UM-Kontakt mit der SIP-Adresse "exumsa1@fabrikam.com" entfernt.

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

Get-CsExUmContact -Filter {LineURI -like "tel:425*"} | Remove-CsExUmContact

In diesem Beispiel werden alle Exchange UM-Kontakte entfernt, deren Werte für "LineURI" mit "tel:425" beginnen. Der erste Teil dieses Befehls ruft das Cmdlet Get-CsExUmContact mit dem Parameter "Filter" auf, wobei dieser Ausdruck als Filter verwendet wird: LineURI -like "tel:425*". Dieser Filter gibt an, dass alle Exchange UM-Kontaktobjekte abgerufen werden sollen, deren Wert für "LineURI" mit der Platzhalterzeichenfolge "tel:425*" übereinstimmt. Anders ausgedrückt: Es werden alle Anschluss-URIs abgerufen, die mit der Zeichenfolge "tel:425" beginnen und einer beliebigen Zeichenfolge enden. Nachdem die Auflistung von Objekten abgerufen wurde, wird sie an das Cmdlet Remove-CsExUmContact weitergeleitet, das alle Elemente in der Auflistung entfernt.