Remove-CsUserAcp
Letztes Änderungsdatum des Themas: 2012-03-25
Entfernt einen oder mehrere Audiokonferenzanbieter, die einem Benutzer oder einer Benutzergruppe zugewiesen sind.
Syntax
Remove-CsUserAcp -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-Name <String>] [-ParticipantPasscode <String>] [-PassThru <SwitchParameter>] [-TollNumber <String>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Bei einem Audiokonferenzanbieter handelt es sich um ein Drittanbieterunternehmen, das Konferenzdienste für Organisationen bereitstellt. Audiokonferenzanbieter bieten u. a. die Möglichkeit für Benutzer, von außerhalb eines Standorts und ohne Verbindung mit dem Unternehmensnetzwerk oder dem Internet am Audioteil einer Konferenz oder Besprechung teilzunehmen. Audiokonferenzanbieter stellen oft hochwertige Dienstleistungen wie Simultanübersetzung, Transkription und operatorgestützte Livekonferenzen bereit.
Microsoft Lync Server 2010 ermöglicht keine vollständige Integration von Audiokonferenzanbietern. Mit den CsUserAcp-Cmdlets können Administratoren eine Telefonnummer und eine Kennung festlegen sowie weitere Informationen konfigurieren, die bei jeder Besprechungsplanung der Benutzer für die Integration eines Audiokonferenzanbieters verwendet werden können. Da diese Cmdlets jedoch nicht für die lokale Version von Lync Server entworfen wurden (sie sind stattdessen primär für die Verwendung mit Microsoft Lync Online 2010 gedacht), ist über die Zuweisung von Eigenschaftswerten hinaus keine weitere Integration von Audiokonferenzanbietern möglich.
Jeder einem Benutzer zugewiesene Audiokonferenzanbieter kann später mit dem Cmdlet Remove-CsUserAcp entfernt werden. Durch Aufrufen von Remove-CsUserAcp ohne Parameter (mit Ausnahme des Parameters "Identity", der das zu ändernde Benutzerkonto angibt), werden alle dem betreffenden Benutzer zugewiesenen Audiokonferenzanbieter entfernt. Alternativ dazu können Sie mit den in Remove-CsUserAcp enthaltenen optionalen Parametern ausgewählte Anbieter aus einem Benutzerkonto entfernen. Verwenden Sie beispielsweise folgenden Befehl, um das Benutzerkonto "Ken Myer" zu suchen und alle Audiokonferenzanbieter mit dem Namen "Fabrikam ACP" zu entfernen:
Remove-CsUserAcp –Identity "Ken Myer" –Name "Fabrikam ACP"
Um das Entfernen von Audiokonferenzanbietern weiter einzuschränken, geben Sie einfach weitere Parameter an. Mit folgendem Befehl werden beispielsweise alle Audiokonferenzanbieter mit dem Namen "Fabrikam ACP" und der gebührenpflichtigen Nummer (TollNumber) 14255551298 entfernt:
Remove-CsUserAcp –Identity "Ken Myer" –Name "Fabrikam ACP" –TollNumber "14255551298"
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Remove-CsUserAcp lokal ausfü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-CsUserAcp"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
Benutzeridentität |
Gibt die Identität des Benutzerkontos an, aus dem der Audiokonferenzanbieter entfernt werden soll. Sie können eine Benutzeridentität in einem von vier Formaten angeben: als 1) SIP-Adresse des Benutzers, 2) Benutzerprinzipalname (User Principal Name, UPN) des Benutzers, 3) Domänen- und Anmeldename des Benutzers (mit dem Format "Domäne\Anmeldename", z. B. "litwareinc\kenmyer") und 4) Anzeigename des Benutzers in den Active Directory-Domänendienste (AD DS) (z. B. "Ken Myer"). Benutzeridentitäten können auch über den Active Directory-DN (Distinguished Name) des Benutzers referenziert werden. Sie können das Sternchen (*) als Platzhalterzeichen nutzen, wenn Sie den Anzeigenamen als Benutzeridentität verwenden. Der Identitätswert "* Smith" gibt beispielsweise alle Benutzer zurück, deren Anzeigename mit der Zeichenfolge "Smith" endet. |
Name |
Optional |
Zeichenfolge |
Name des Audiokonferenzanbieters. Beispiel: -Name "Fabrikam Conference Services". |
ParticipantPassCode |
Optional |
Zeichenfolge |
Beim Herstellen einer Verbindung mit einer Konferenz über den Audiokonferenzanbieter erforderliche Kennung. Beispiel: -PassCode "0712". |
TollNumber |
Optional |
Zeichenfolge |
Gebührenpflichtige Telefonnummer für Audiokonferenzen. Beispiel: -TollNumber "14255551298". |
PassThru |
Optional |
Switch-Parameter |
Ermöglicht das Weiterleiten eines Benutzerobjekts, das den Benutzer darstellt, dessen Audiokonferenzanbieter entfernt wird. Mit dem Cmdlet Remove-CsUserAcp werden Objekte standardmäßig nicht weitergeleitet. |
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
Zeichenfolge oder Microsoft.Rtc.Management.ADConnect.Schema.ADUser-Objekt. Remove-CsUserAcp akzeptiert einen weitergeleiteten Zeichenfolgenwert, der die Identität eines für Microsoft Lync Server 2010 aktivierten Benutzers repräsentiert. Das Cmdlet akzeptiert auch weitergeleitete Instanzen des Active Directory-Benutzerobjekts.
Rückgabetypen
Keine.
Beispiel
-------------------------- Beispiel 1 ------------------------
Remove-CsUserAcp -Identity "Ken Myer"
Der Befehl in Beispiel 1 entfernt alle Audiokonferenzanbieter, die dem Benutzer "Ken Myer" zugewiesen sind.
-------------------------- Beispiel 2 ------------------------
Get-CsUser | Remove-CsUserAcp
Beispiel 2 zeigt, wie Sie alle Audiokonferenzanbieter entfernen können, die allen für Lync Server 2010 aktivierten Benutzern zugewiesen sind. Dazu ruft der Befehl zunächst mit Get-CsUser eine Auflistung aller für Lync Server aktivierten Benutzer ab. Diese Auflistung wird dann an das Cmdlet Remove-CsUserAcp weitergeleitet, das alle Audiokonferenzanbieter entfernt, die den einzelnen Benutzern in der Auflistung zugewiesen sind.
-------------------------- Beispiel 3 ------------------------
Remove-CsUserAcp -Identity "Ken Myer" -Name "Fabrikam ACP"
In Beispiel 3 werden alle Audiokonferenzanbieter mit dem Namen "Fabrikam ACP" aus dem Benutzerkonto "Ken Myer" entfernt.
-------------------------- Beispiel 4 ------------------------
Get-CsUserAcp | Where-Object {$_.AcpInfo -match "14255551298"} | Remove-CsUserAcp
Mit dem vorstehenden Befehl wird der Audiokonferenzanbieter mit der gebührenpflichtigen Nummer 14255551298 aus allen Benutzerkonten entfernt, denen ein Audiokonferenzanbieter zugewiesen ist. Dazu ruft der Befehl zunächst Get-CsUserAcp auf, um Informationen zu allen Audiokonferenzanbietern zurückzugeben, die allen Benutzern zugewiesen sind. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Konten herausfiltert, bei denen die Eigenschaft "AdpInfo" die Telefonnummer 14255551298 enthält (der Vergleichsoperator "-match" steht für "matches"). Diese gefilterte Auflistung wird anschließend an das Cmdlet Remove-CsUserAcp weitergeleitet, das die entsprechenden Audiokonferenzanbieter aus sämtlichen Konten in der gefilterten Auflistung entfernt.