Get-CsAdUser
Letztes Änderungsdatum des Themas: 2012-03-23
Gibt Informationen zu allen Benutzerkonten in Active Directory-Domänendienste (AD DS) zurück. Hierzu gehören Benutzerkonten, die für Microsoft Lync Server 2010 aktiviert wurden, sowie Konten, die für Lync Server 2010 nicht aktiviert wurden.
Syntax
Get-CsAdUser [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-LDAPFilter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]
Detaillierte Beschreibung
Get-CsAdUser gibt Informationen zu allen Benutzerkonten in Active Directory zurück, einschließlich Benutzerkonten, die für Lync Server aktiviert wurden, und Benutzerkonten, die nicht für diese Komponente aktiviert sind. Dieses Cmdlet unterscheidet sich vom Cmdlet Get-CsUser, das Informationen ausschließlich für Benutzer zurückgibt, deren Konten für Lync Server oder eine vorherige Version der Software (z. B. Microsoft Office Communications Server 2007 R2) aktiviert wurden.
Trotz gewisser Überschneidungen zwischen den beiden Cmdlets werden mit Get-CsAdUser und Get-CsUser unterschiedliche Arten von Informationen zurückgegeben. Im Allgemeinen werden mit Get-CsUser Werte für Active Directory-Attribute zurückgegeben, die sich speziell auf Lync Server beziehen. Mit Get-CsUser können Sie z. B. folgende Informationen zurückgeben: die Lync Server-Richtlinien, die einem Benutzer zugewiesen sind, den für diesen Benutzer konfigurierten Anschluss-URI (Uniform Resource Identifier) sowie Einzelheiten dazu, ob der Benutzer für Enterprise-VoIP aktiviert wurde. Diese Attribute sind nur dann Teil eines Benutzerkontos, wenn der Benutzer für Lync Server aktiviert ist.
Get-CsAdUser hingegen gibt allgemeine Active Directory-Attributwerte zurück, also Informationen zu Attributen, die Teil des grundlegenden Benutzerkontos in Active Directory und unabhängig davon vorhanden sind, ob ein Benutzer für Lync Server aktiviert ist oder nicht. Get-CsAdUser gibt beispielsweise Informationen wie die Abteilung und die Organisation zurück, in welcher der Benutzer arbeitet, sowie seine Position, Telefonnummer und Büroadresse. Um eine vollständige Liste der Attributwerte anzuzeigen, die von Get-CsAdUser zurückgegeben werden, geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein:
Get-CsAdUser | Get-Member
Get-CsAdUser bietet mehrere Möglichkeiten, um die Auflistung von Benutzern zu filtern, die beim Ausführen des Cmdlets zurückgegeben werden. Wenn Sie z. B. nicht alle Active Directory-Benutzerkonten zurückgeben möchten, können Sie die optionalen Parameter "Filter" und "LdapFilter" anwenden. Diese Parameter schließen sich gegenseitig aus: Bei Verwendung des Parameters "Filter" kann der Parameter "LdapFilter" nicht innerhalb desselben Befehls verwendet werden und umgekehrt. Über den Parameter "Filter" können die zurückgegebenen Daten auf Benutzer beschränkt werden, die mit den angegebenen Kriterien für Lync Server-spezifische Attribute übereinstimmen. Beispielsweise können Sie mit dem Parameter "Filter" eine Auflistung von Benutzern zurückgeben, die für Lync Server aktiviert wurden bzw. nicht aktiviert wurden. Bei Verwendung des Parameters "LdapFilter" können Sie die zurückgegebenen Daten auf Benutzer beschränken, die andere auf generischen Active Directory-Attributen basierende Kriterien erfüllen. Beispielsweise können Benutzer zurückgegeben werden, die in einem bestimmten Bundesland oder Kanton arbeiten, nicht über einen Pager verfügen oder eine bestimmte Position innehaben.
Folgendes ist beim Cmdlet "Get-CsAdUser" zu beachten: Wenngleich das Attribut "Enabled", das bestimmt, ob ein Benutzer für Lync Server aktiviert wurde, einen booleschen Wert hat, gibt es für diese Eigenschaft tatsächlich drei gültige Werte:
"True". Der Benutzer wurde für Lync Server aktiviert.
"False". Der Benutzer hat sein Konto für Lync Server vorübergehend deaktiviert. Dies erfolgt zumeist mithilfe des Cmdlets "Set-CsUser" und der Festlegung des Parameters "Enabled" auf "$False".
"Null". Der Benutzer wurde nicht für Lync Server aktiviert.
Wenn Sie eine Liste mit Benutzern erhalten möchten, die nicht für Lync Server aktiviert sind, müssen Sie demnach einen Befehl wählen, der alle Benutzer zurückgibt, deren Attribut "Enabled" auf "Null" festgelegt ist:
Get-CsAdUser –Filter {Enabled –eq $Null}
Mit dem folgenden Befehl werden hingegen nur Benutzer zurückgegeben, deren Lync Server-Konten vorübergehend deaktiviert wurden:
Get-CsAdUser –Filter {Enabled –eq $False}
Benutzer, die nicht für Lync Server aktiviert wurden, werden bei Ausführung des vorherigen Befehls nicht zurückgegeben:
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Get-CsAdUser lokal auszuführen: RTCUniversalUserAdmins, RTCUniversalServerAdmins, 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-CsAdUser"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
UserID-Parameter |
Gibt den Identitätswert des Benutzerkontos an, das abgerufen werden soll. Benutzeridentitäten können in den folgenden vier Formaten angegeben werden: 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) Active Directory-Anzeigename des Benutzers (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 auf den Zeichenfolgenwert " Smith" endet. |
Credential |
Optional |
PS-Objekt mit Anmeldeinformationen |
Ermöglicht die Ausführung des Cmdlets Get-CsAdUser mit anderen Anmeldeinformationen. Dies kann notwendig sein, wenn das für die Anmeldung an Windows verwendete Konto nicht über die erforderlichen Berechtigungen verfügt, um mit Benutzerobjekten zu arbeiten. Zur Verwendung des Parameters "Credential" muss zunächst über das Cmdlet Get-Credential ein PSCredential-Objekt erstellt werden. Einzelheiten finden Sie im Hilfethema Get-Credential. |
DomainController |
Optional |
Zeichenfolge |
Ermöglicht es Ihnen, zum Abrufen von Benutzerinformationen eine Verbindung mit dem angegebenen Domänencontroller herzustellen. Um eine Verbindung mit einem bestimmten Domänencontroller herzustellen, fügen Sie den Parameter "DomainController" ein, gefolgt vom vollqualifizierten Domänennamen (z. B. "atl-cs-001.litwareinc.com"). |
Filter |
Optional |
Zeichenfolge |
Ermöglicht die Einschränkung der zurückgegebenen Daten, indem diese nach Lync Server-spezifischen Attributen gefiltert werden. Der Parameter "Filter" verwendet dieselbe Windows PowerShell-Filterungssyntax wie das Cmdlet Where-Object. Beispielsweise sieht ein Filter zum Zurückgeben von Benutzern, die nicht für Lync Server aktiviert sind, folgendermaßen aus: {Enabled -ne $True}. Dabei ist "Enabled" das Active Directory-Attribut, "-ne" der Vergleichsoperator ("not equal to") und "$True" (eine integrierte Windows PowerShell-Variable) der Wert "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. |
OU |
Optional |
Distinguished Name |
Ermöglicht es Ihnen, Benutzer aus einer bestimmten Active Directory-Organisationseinheit (Organizational Unit, OU) oder aus einem bestimmten Container zurückzugeben. Mit diesem Parameter werden Daten aus der angegebenen Organisationseinheit und allen untergeordneten Organisationseinheiten zurückgegeben. Wenn die OU "Finance" z. B. über zwei untergeordnete OUs verfügt – "AccountsPayable" und "AccountsReceivable" – werden alle Benutzer aus diesen drei OUs zurückgegeben. Verwenden Sie beim Angeben einer Organisationseinheit den Distinguished Name (DN) des Containers, z. B.: OU=Finance,dc=litwareinc,dc=com. Verwenden Sie die folgende Syntax, um Benutzer aus dem Container "Users" zurückzugeben: cn=Users,dc=litwareinc,dc=com. |
ResultSize |
Optional |
Ganze Zahl |
Ermöglicht es Ihnen, die Anzahl der vom Cmdlet zurückgegebenen Datensätze einzuschränken. Um beispielsweise sieben Benutzer zurückzugeben (unabhängig von der Gesamtzahl der Benutzer in der Gesamtstruktur), verwenden Sie den Parameter "ResultSize", und setzen Sie seinen Wert auf 7. Beachten Sie, dass nicht garantiert werden kann, welche sieben Benutzer zurückgegeben werden. 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. 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. |
Eingabetypen
Zeichenfolge. Get-CsAdUser akzeptiert einen weitergeleiteten Zeichenfolgenwert, der den Identitätswert eines Active Directory-Benutzerkontos darstellt.
Rückgabetypen
Get-CsAdUser gibt Instanzen des Objekts "Microsoft.Rtc.Management.ADConnect.Schema.CSADUser" zurück.
Beispiel
-------------------------- Beispiel 1 --------------------------
Get-CsAdUser
Über den in Beispiel 1 gezeigten Befehl wird eine Auflistung aller Benutzerkonten in Ihrer Active Directory-Domäne zurückgegeben.
-------------------------- Beispiel 2 --------------------------
Get-CsAdUser -Identity "Pilar Ackerman"
In Beispiel 2 gibt Get-CsAdUser Informationen zum Benutzerkonto von Pilar Ackerman zurück. In diesem Beispiel wird der Anzeigename der Benutzerin verwendet, um die Identität anzugeben.
-------------------------- Beispiel 3 --------------------------
Get-CsAdUser -OU "ou=Finance,dc=litwareinc,dc=com"
In Beispiel 3 werden Benutzerkontoinformationen zu allen Benutzern in der Organisationseinheit "Finance" zurückgegeben. Hierzu muss der Distinguished Name (DN) der Organisationseinheit an den Parameter "OU" übergeben werden.
-------------------------- Beispiel 4 --------------------------
Get-CsAdUser -Filter {Enabled -ne $True} | Select-Object DisplayName
Im vorstehenden Befehl werden alle Benutzer zurückgegeben, die nicht für Lync Server 2010 oder Office Communications Server aktiviert wurden. Hierzu wird der Parameter "Filter" mit Get-CsAdUser verwendet, um die zurückgegebenen Daten auf Benutzerkonten zu beschränken, bei denen die Eigenschaft "Enabled" nicht den Wert "True" aufweist. Über diesen Filter wird Get-CsAdUser angewiesen, nur Benutzerkonten zurückzugeben, die nicht für die Verwendung mit Lync Server oder Office Communications Server aktiviert wurden. Nach dem Abruf der Daten werden die Informationen an das Cmdlet Select-Object weitergeleitet, das anschließend nur die Eigenschaft (in diesem Fall "DisplayName") ermittelt, die tatsächlich auf dem Bildschirm angezeigt wird.
-------------------------- Beispiel 5 --------------------------
Get-CsAdUser -LdapFilter "Department=Finance"
In Beispiel 5 wird der Parameter "LdapFilter" verwendet, um die zurückgegebenen Daten auf Benutzer in der Abteilung "Finance" zu beschränken. Dies wird durch Verwendung des LDAP-Filterwerts "Department=Finance" erreicht.