Set-CsUserAcp
Letztes Änderungsdatum des Themas: 2012-03-27
Fügt einem Benutzer oder einer Benutzergruppe einen neuen Audiokonferenzanbieter hinzu oder ändert einen vorhandenen Audiokonferenzanbieter, der bereits einem Benutzer zugewiesen ist.
Syntax
Set-CsUserAcp -Identity <UserIdParameter> -Domain <String> -Name <String> -ParticipantPasscode <String> -TollNumber <String> [-Confirm [<SwitchParameter>]] [-IsDefault <$true | $false>] [-PassThru <SwitchParameter>] [-TollFreeNumbers <String[]>] [-Url <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 auch 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.
Audiokonferenzanbieter können einem Benutzerkonto über das Cmdlet Set-CsUserAcp zugewiesen werden. (Beachten Sie, dass Benutzern mehrere Audiokonferenzanbieter zugewiesen werden können.) Set-CsUserAcp wird auch zum Ändern der Eigenschaften eines vorhandenen Audiokonferenzanbieters verwendet. Wenn Sie Set-CsUserAcp aufrufen, prüft das Cmdlet anhand der im Anruf enthaltenen Parameterinformationen die vorhandenen Audiokonferenzanbieter, die dem Benutzer bereits zugewiesen sind. Wird eine Entsprechung gefunden, wird der vorhandene Anbieter geändert. Nehmen Sie zum Beispiel an, Sie führen den folgenden Befehl aus:
Set-CsUserAcp –Identity "Ken Myer" –TollNumber "15554251298" –ParticipantPassCode 13761 –Domain "fabrikam.com" –Name "Fabrikam ACP"
Nehmen Sie weiterhin an, dass Ken Myer bereits ein Audiokonferenzanbieter namens "Fabrikam ACP" zugewiesen wurde, der dieselbe "TollNumber" und "Domain" besitzt wie im Befehl angegeben. (Der einzige Unterschied liegt also bei "ParticipantPassCode".) In diesem Fall ändert Set-CsUserAcp den vorhandenen Anbieter "Fabrikam ACP". Wird keine Entsprechung gefunden, wird dem Benutzerkonto von Ken Myer ein neuer Anbieter hinzugefügt.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Set-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 "Set-CsUserAcp"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
Benutzeridentität |
Gibt die Identität des zu ändernden Benutzerkontos an. Sie können eine Benutzeridentität in einem von vier Formaten angeben: als 1) SIP-Adresse des Benutzers, 2) UPN (User Principal Name) 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 auf den Zeichenfolgenwert "Smith" endet. |
Domain |
Erforderlich |
Zeichenfolge |
Domänenname des Audiokonferenzanbieters. Beispiel: -Domain "fabrikam.com". |
Name |
Erforderlich |
Zeichenfolge |
Name des Audiokonferenzanbieters. Beispiel: -Name "Fabrikam Conference Services". |
ParticipantPasscode |
Erforderlich |
Zeichenfolge |
Beim Herstellen einer Verbindung mit einer Konferenz über den Audiokonferenzanbieter erforderliche Kennung. Beispiel: -PassCode "0712". |
TollNumber |
Erforderlich |
Zeichenfolge |
Gebührenpflichtige Telefonnummer für Audiokonferenzen. Beispiel: -TollNumber "14255551298". |
IsDefault |
Optional |
Boolescher Wert |
Gibt an, ob es sich um den Standard-Audiokonferenzanbieter für den Benutzer handelt. Jeder Benutzer kann nur einen Standardanbieter besitzen. |
TollFreeNumbers |
Optional |
Zeichenfolge |
Auflistung gebührenfreier Telefonnummern für Audiokonferenzen. Beispiel: -TollFreeNumbers "18005551298". Zum Hinzufügen mehrerer gebührenfreier Nummern trennen Sie die einzelnen Nummern durch Kommas: -TollFreeNumber "18005551298", "18005559876". |
Url |
Optional |
Zeichenfolge |
Internet-URL für den Audiokonferenzanbieter. Beispiel: -Url "http://acp.fabrikam.com". Mit der Internet-URL können Audiokonferenzanbieter Benutzer an eine Webseite verweisen, die zusätzliche Einwahltelefonnummern sowie Informationen zu den vom Audiokonferenzanbieter angebotenenen Diensten enthält. |
PassThru |
Optional |
Switch-Parameter |
Ermöglicht das Weiterleiten eines Benutzerobjekts, das den Benutzer darstellt, dessen Audiokonferenzanbieter entfernt wird. Mit dem Cmdlet Set-CsUserAcp werden standardmäßig keine Objekte 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. Set-CsUserAcp akzeptiert einen weitergeleiteten Zeichenfolgenwert, der die Identität eines für Lync Server 2010 aktivierten Benutzers darstellt. Das Cmdlet akzeptiert auch weitergeleitete Instanzen des Active Directory-Benutzerobjekts.
Rückgabetypen
Keine.
Beispiel
-------------------------- Beispiel 1 --------------------------
Set-CsUserAcp -Identity "Ken Myer" -TollNumber "14255551298" -ParticipantPassCode 13761 -Domain "fabrikam.com" -Name "Fabrikam ACP"
In Beispiel 1 wird Set-CsUserAcp verwendet, um dem Benutzer Ken Myer einen neuen Audiokonferenzanbieter zuzuweisen. Hierzu wird über den Parameter "Identity" das zu ändernde Benutzerkonto angegeben. Zusätzlich werden die erforderlichen Parameter "TollNumber", "ParticipantPassCode", "Domain" und "Name" zusammen mit den entsprechenden Parameterwerten angegeben.
-------------------------- Beispiel 2 --------------------------
Get-CsUser -LdapFilter "Department=Finance" | Set-CsUserAcp -TollNumber "14255551298" -ParticipantPassCode 13761 -Domain "fabrikam.com" -Name "Fabrikam ACP"
Der Befehl in Beispiel 2 weist denselben Audiokonferenzanbieter allen Benutzern zu, die in der Abteilung "Finance" arbeiten. Hierzu verwendet der Befehl zunächst Get-CsUser und den "LdapFilter" (mit dem Filterwert "Department=Finance"), um eine Auflistung aller Benutzer zurückzugeben, die in der Abteilung "Finance" arbeiten. Diese Auflistung wird anschließend an das Cmdlet Set-CsUserAcp weitergeleitet, das jedem Benutzer in der Auflistung denselben Audiokonferenzanbieter (Fabrikam ACP) zuweist.
-------------------------- Beispiel 3 --------------------------
Set-CsUserAcp -Identity "Ken Myer" -TollNumber "14255551298" -ParticipantPassCode 13761 -Domain "fabrikam.com" -Name "Fabrikam ACP" -TollFreeNumbers "18005551010", "18005551020"
Der vorstehende Befehl weist dem Benutzer Ken Myer den Audiokonferenzanbieter "Fabrikam ACP" zu. Zusätzlich zu "TollNumber", "ParticipantPassCode", "Domain" und "Name" umfasst dieser Befehl ein Paar gebührenfreier Telefonnummern. Um diese beiden Werte zuzuweisen, wird der Parameter "TollFreeNumbers" gefolgt von den beiden Telefonnummern angegeben, die durch Komma voneinander getrennt sind.