Get-CsUserAcp
Letztes Änderungsdatum des Themas: 2012-03-23
Gibt Informationen zu Audiokonferenzanbietern zurück, die einem Benutzer oder einer Benutzergruppe zugewiesen sind.
Syntax
Get-CsUserAcp [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-Filter <String>] [-LdapFilter <String>] [-ResultSize <Unlimited>]
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.
Mit dem Cmdlet Get-CsUserAcp können Sie Informationen zu Audiokonferenzanbietern zurückgeben, die einem Benutzer oder einer Benutzergruppe zugewiesen sind. Zum Zurückgeben von Informationen zu Audiokonferenzanbietern für einen einzelnen Benutzer geben Sie einfach den Parameter "Identity" an, gefolgt von der Identität des Benutzers, für den Informationen zurückgegeben werden sollen. Zum Zurückgeben von Informationen für mehrere Benutzer können Sie den Parameter "LdapFilter" oder den Parameter "Filter" verwenden. Der Parameter "LdapFilter" ermöglicht es Ihnen, beim Angeben von Benutzerkontoinformationen generische Active Directory-Attribute wie "Department" oder "Titel" zu verwenden. Beispielsweise beschränkt der Parameterwert "Title=Accountant" die zurückgegebenen Informationen auf Benutzer mit der Position "Accountant". Mit dem Parameter "Filter" können Sie zum Filtern der zurückgegebenen Daten Microsoft Lync Server 2010-spezifische Attribute verwenden (z. B. "VoicePolicy" oder "EnterpriseVoiceEnabled"). Beispielsweise beschränkt der Filterwert "{EnterpriseVoiceEnabled –eq $True}" die von Get-CsUserAcp zurückgegebenen Benutzerkonten auf Benutzer, die für Enterprise-VoIP aktiviert sind.
Alternativ dazu haben Sie die Möglichkeit, Get-CsUserAcp ohne Parameter aufzurufen, um Informationen zu Audiokonferenzanbietern für alle Benutzer zurückzugeben. Beachten Sie, dass Get-CsUserAcp Informationen zu Audiokonferenzanbietern für alle Benutzer zurückgibt, d. h. auch für Benutzer, die nicht für Lync Server aktiviert sind.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Get-CsUserAcp lokal auszuführen: RTCUniversalUserAdmins, RTCUniversalReadOnlyAdmins. 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 "Get-CsUserAcp"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
Benutzeridentität |
Gibt den Identitätswert des Benutzerkontos an, das abgerufen 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"). Sie können auch unter Verwendung des Active Directory-Distinguished Name (DN) des Benutzers auf ein Benutzerkonto verweisen. 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. |
Credential |
Optional |
PS-Objekt mit Anmeldeinformationen |
Ermöglicht die Ausführung des Cmdlets Get-CsUserAcp mit anderen Anmeldeinformationen. Dies kann notwendig sein, wenn das für die Anmeldung bei Windows verwendete Konto nicht über die erforderlichen Berechtigungen verfügt, um mit Kontaktobjekten zu arbeiten. Zur Verwendung des Parameters "Credential" muss zunächst mit dem Cmdlet Get-Credential das PS-Objekt mit Anmeldeinformationen erstellt werden. Einzelheiten finden Sie im Hilfethema zum Cmdlet Get-Credential. |
Filter |
Optional |
Zeichenfolge |
Ermöglicht die Einschränkung der zurückgegebenen Daten, indem diese nach Lync Server-spezifischen Attributen gefiltert werden. Die zurückgegebenen Daten können z. B. auf Benutzer beschränkt werden, denen eine bestimmte VoIP-Richtlinie zugewiesen ist, oder Benutzer, denen keine spezifische VoIP-Richtlinie zugewiesen wurde. Der Parameter "Filter" verwendet dieselbe Windows PowerShell-Filtersyntax wie das Cmdlet Where-Object. Beispielsweise sieht ein Filter, der nur Benutzer für Enterprise-VoIP aktivierte Benutzer zurückgibt, wie nachstehend gezeigt aus. "EnterpriseVoiceEnabled" repräsentiert das Active Directory-Domänendienste (AD DS)-Attribut, "-eq" den Vergleichsoperator "equal to" und "$True" (eine integrierte Windows PowerShell-Variable) den Filterwert: {EnterpriseVoiceEnabled -eq $True} |
LdapFilter |
Optional |
Zeichenfolge |
Ermöglicht es Ihnen, die zurückgegebenen Daten durch das Filtern allgemeiner Active Directory-Attribute einzuschränken (d. h. Attribute, die nicht Lync Server-spezifisch sind). Beispielsweise können die zurückgegebenen Daten auf Benutzer beschränkt werden, die in einer bestimmten Abteilung arbeiten, oder auf Benutzer mit einem bestimmten Vorgesetzten oder einer bestimmten Position. Der Parameter "LdapFilter" verwendet beim Erstellen von Filtern die LDAP-Abfragesprache. Im folgenden Beispiel wird ein Filter gezeigt, der nur Benutzer zurückgibt, die in Redmond arbeiten: "l=Redmond". Dabei ist "l" (klein geschriebenes "L") das Active Directory-Attribut ("l" steht für "locality", Deutsch: Ort), "=" ist der Vergleichsoperator (equal to) und "Redmond" der Filterwert. |
ResultSize |
Optional |
Ganze Zahl |
Ermöglicht es Ihnen, die Anzahl von zurückgegebenen Datensätzen einzuschränken. Um beispielsweise sieben Benutzer zurückzugeben (unabhängig von der Anzahl von Benutzern in der Gesamtstruktur), verwenden Sie den Parameter "ResultSize" und setzen seinen Wert auf 7. Beachten Sie, dass nicht garantiert werden kann, welche sieben Benutzer zurückgegeben werden. Wenn Sie "ResultSize" auf 7 festlegen, jedoch nur drei Benutzer in Ihrer Gesamtstruktur vorhanden sind, werden diese drei Benutzer zurückgegeben, und der Befehl wird anschließend ohne Fehler abgeschlossen. Für die Ergebnisgröße kann ein ganzzahliger Wert zwischen einschließlich 0 und 2147483647 festgelegt werden. Bei Festlegung von 0 wird der Befehl ausgeführt, es werden jedoch keine Daten zurückgegeben. |
Eingabetypen
Zeichenfolge. Get-CsUserAcp akzeptiert einen weitergeleiteten Zeichenfolgenwert, der die Identität eines für Lync Server 2010 aktivierten Benutzers repräsentiert.
Rückgabetypen
Mit "Get-CsUserAcp" werden Instanzen des Objekts "Microsoft.Rtc.Management.ADConnect.Schema.ADUserAcp" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 ------------------------
Get-CsUserAcp
Der Befehl in Beispiel 1 gibt Informationen zu Audiokonferenzanbietern für alle Benutzer in der Organisation zurück.
-------------------------- Beispiel 2 ------------------------
Get-CsUserAcp -Identity "Ken Myer"
Mit dem vorstehenden Befehl werden Informationen zu Audiokonferenzanbietern für nur einen Benutzer zurückgegeben: den Benutzer mit der Identität "Ken Myer". In diesem Fall wird die Identität anhand des Active Directory-Anzeigenamens des Benutzers angegeben.
-------------------------- Beispiel 3 ------------------------
Get-CsUserAcp -Filter {AcpInfo -ne $Null}
In Beispiel 3 werden Informationen für alle Benutzer zurückgegeben, denen mindestens ein Audiokonferenzanbieter zugewiesen ist. Dazu wird der Parameter "Filter" mit dem Filterwert "{AcpInfo –ne $Null}" angegeben. Dieser Filterwert beschränkt die zurückgegebenen Daten auf Benutzer, bei denen der Wert der Eigenschaft "AcpInfo" keinen Nullwert aufweist. Um Informationen zu Benutzern zurückzugeben, denen kein Audiokonferenzanbieter zugewiesen ist, verwenden Sie folgenden Filterwert:
{AcpInfo –eq $Null}
-------------------------- Beispiel 4 ------------------------
Get-CsUserAcp | Where-Object {$_.AcpInfo -match "Fabrikam ACP"
Mit dem vorstehenden Befehl werden Informationen zu Audiokonferenzanbietern für alle Benutzer zurückgegeben, denen der Audiokonferenzanbieter "Fabrikam ACP" zugewiesen ist. Dazu ruft der Befehl zunächst Get-CsUserAcp ohne Parameter auf, um eine Auflistung von Informationen zu Audiokonferenzanbietern für alle Benutzer in der Organisation zurückzugeben. Diese Informationen werden dann an das Cmdlet Where-Object weitergeleitet, das die Benutzer herausfiltert, bei denen die Eigenschaft "AcpInfo" die Zeichenfolge "Fabrikam ACP" enthält (der Vergleichsoperator "-match" steht für "matches").
-------------------------- Beispiel 5 ------------------------
Get-CsUserAcp -Identity "Ken Myer" | Select-Object -ExpandProperty AcpInfo
In Beispiel 5 werden ausführliche Informationen zu den Audiokonferenzanbietern angezeigt, die dem Benutzer "Ken Myer" zugewiesen sind. Dazu wird zunächst Get-CsUserAcp aufgerufen, um Informationen zu Audiokonferenzanbietern für Ken Myer zurückzugeben. Diese Daten werden dann an das Cmdlet Select-Object weitergeleitet, das den Parameter "ExpandProperty" zum "Erweitern" des Werts der Eigenschaft "AcpInfo" verwendet. Beim Erweitern eines Eigenschaftswerts werden alle in diesem Wert gespeicherten Informationen in einem benutzerfreundlichen Format angezeigt.