Get-CsUser

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen zu allen Benutzern in Ihrer Organisation zurück, die für Microsoft Lync Server 2010 oder eine Vorgängerversion der Software (z. B. Microsoft Office Communications Server 2007 R2) aktiviert wurden.

Syntax

Get-CsUser [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-LdapFilter <String>] [-OnLyncServer <SwitchParameter>] [-OnOfficeCommunicationServer <SwitchParameter>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>] [-UnAssignedUser <SwitchParameter>]

Detaillierte Beschreibung

Bei gleichzeitiger Verwendung der Cmdlets Get-CsAdUser und Get-CsUser können Sie ausführliche Informationen zu allen Active Directory-Benutzerkonten zurückgeben. Get-CsAdUser gibt Informationen zu allen Benutzerkonten zurück, einschließlich Benutzern, die für Lync Server 2010 oder Office Communications Server aktiviert wurden, und Benutzern, die nicht für Lync Server oder Office Communications Server aktiviert wurden. Damit unterscheidet es sich von Get-CsUser, das nur Informationen zu Benutzern zurückgibt, deren Konten für Lync Server oder Office Communications Server aktiviert wurden.

Trotz gewisser Überschneidungen zwischen den beiden Cmdlets werden mit Get-CsUser und Get-CsAdUser 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 werden beispielsweise folgende Informationen zurückgegeben: die Lync Server-Richtlinien, die einem Benutzer zugewiesen wurden; der diesem Benutzer zugewiesene Anschluss-URI (Uniform Resource Identifier) sowie Informationen 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.

Im Gegensatz dazu gibt Get-CsAdUser allgemeine Active Directory-Attributwerte zurück: d. h. Attributwerte, die Teil des grundlegenden Active Directory-Benutzerkontos sind und die unabhängig davon vorhanden sind, ob ein Benutzer für Lync Server aktiviert wurde. Mit Get-CsAdUser werden beispielsweise folgende Informationen zurückgegeben: die Abteilung und Organisation, für die der Benutzer tätig ist, sowie die Position, die Telefonnummer und Büroanschrift des Benutzers.

Um eine vollständige Liste der Attributwerte anzuzeigen, die von Get-CsUser zurückgegeben werden, geben Sie den folgenden Befehl an der Microsoft Windows PowerShell-Eingabeaufforderung ein:

Get-CsUser | Get-Member

Get-CsUser bietet mehrere Möglichkeiten, um die Auflistung von Benutzern zu filtern, die beim Ausführen des Cmdlets zurückgegeben werden. Wenn Sie beispielsweise nicht alle Lync Server-Benutzerkonten zurückgeben möchte, können Sie die optionalen Parameter "Filter" oder "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 Sie die zurückgegebenen Daten auf Benutzer beschränken, welche die angegebenen Kriterien für Lync Server erfüllen. So können z. B. nur Benutzer mit Konten im angegebenen Registrierungspool oder nur für Enterprise-VoIP aktivierte Benutzer zurückgegeben werden. Bei Verwendung des Parameters "LDAPFilter" können Sie die zurückgegebenen Daten auf Benutzer beschränken, die andere Active Directory-basierte 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.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Get-CsUser 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-CsUser\b"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

UserIDParameter

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-CsUser 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 zum Cmdlet 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. 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-Filterungssyntax 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-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.

OnOfficeCommunicationServer

Optional

Switch-Parameter

Gibt eine Auflistung von Benutzern zurück, die sich auf einer früheren Version von Lync Server befinden (z. B. Office Communications Server 2007 R2). Benutzer mit Konten in der aktuellen Version der Software werden bei diesem Parameter nicht zurückgegeben.

OnLyncServer

Optional

Switch-Parameter

Gibt eine Auflistung von Benutzern zurück, die sich auf Lync Server 2010 befinden. Benutzer mit Konten in früheren Versionen der Software werden bei diesem Parameter nicht zurückgegeben.

OU

Optional

Distinguished Name

Ermöglicht es Ihnen, Informationen zu Benutzerkonten in einer spezifischen Organisationseinheit (Organizational Unit, OU) oder in einem spezifischen Container zurückzugeben. Der Parameter "OU" gibt Daten aus der angegebenen OU und allen untergeordneten OUs zurück. 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 "OU=Finance,dc=litwareinc,dc=com". Verwenden Sie die folgende Syntax, um Benutzerkonten aus dem Container "Users" zurückzugeben: -OU "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 (unabhängig von der Gesamtzahl der Benutzer in der Gesamtstruktur) zurückzugeben, verwenden Sie den Parameter "ResultSize", und legen Sie den Parameterwert auf 7 fest. 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.

UnassignedUser

Optional

Switch-Parameter

Ermöglicht die Rückgabe einer Auflistung aller Benutzer, die für Lync Server aktiviert wurden, aber derzeit keinem Registrierungspool zugewiesen sind. Benutzer dürfen sich nur bei Lync Server anmelden, wenn sie einem Registrierungspool zugewiesen sind.

Eingabetypen

Zeichenfolge. Get-CsUser akzeptiert einen weitergeleiteten Zeichenfolgenwert, der die Identität eines für Lync Server 2010 aktivierten Benutzers repräsentiert.

Rückgabetypen

Mit Get-CsUser werden Instanzen des Objekts "Microsoft.Rtc.Management.ADConnect.Schema.ADUser" zurückgegeben.

Beispiel

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

Get-CsUser

Im vorstehenden Beispiel wird Get-CsUser ohne Parameter aufgerufen, um eine Auflistung aller Domänenbenutzer zurückzugeben, die für Lync Server oder Office Communications Server aktiviert wurden.

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

Get-CsUser | Format-Table -Property DisplayName, SipAddress, EnterpriseVoiceEnabled -AutoSize

In Beispiel 2 wird Get-CsUser für die Rückgabe einer Auflistung aller Domänenbenutzer verwendet, die für Lync Server oder Office Communications Server aktiviert wurden. Mit Get-CsUser wird standardmäßig eine sehr große Anzahl von Eigenschaften und Eigenschaftswerten zurückgegeben, von denen die meisten von geringem Interesse sind. Daher werden die Daten in diesem Beispiel an das Cmdlet Format-Table weitergeleitet. Mit Format-Table werden dann unter Verwendung des Parameters "Property" die Eigenschaften "DisplayName", "SipAddress" und "EnterpriseVoiceEnabled" ausgewählt und mit den zugehörigen Werten in einer Tabelle angezeigt.

-------------------------- Beispiel 3 --------------------------

Get-CsUser -Identity "Pilar Ackerman"

In Beispiel 3 wird der Parameter "Identity" verwendet, um die zurückgegebenen Daten auf das Benutzerkonto mit dem Identitätswert (in diesem Fall der Anzeigename) "Pilar Ackerman" zu beschränken.

-------------------------- Beispiel 4 --------------------------

Get-CsUser -Identity "Pilar*"

In Beispiel 4 wird das Platzhalterzeichen (*) beim Angeben des Identitätswerts des Benutzers verwendet. Dies führt dazu, dass Get-CsUser alle Benutzer zurückgibt, deren Identität mit dem Zeichenfolgenwert "Pilar" beginnt.

-------------------------- Beispiel 5 --------------------------

Get-CsUser -Filter {VoicePolicy -eq $Null}

Der Befehl in Beispiel 5 gibt eine Auflistung von Benutzern zurück, denen keine benutzerbasierte VoIP-Richtlinie zugewiesen wurde. Dazu verwendet der Befehl den Parameter "Filter", gefolgt vom Filter "VoicePolicy -eq "$Null. Beim Erstellen von Filtern für die Verwendung mit Get-CsUser müssen Sie den Eigenschaftennamen (VoicePolicy) gefolgt vom Vergleichsoperator angeben (in diesem Fall "-eq", dem Vergleichsoperator mit der Bedeutung "equal to"). Direkt im Anschluss an den Vergleichsoperator folgt der Wert, auf den getestet wird. In diesem Beispiel entspricht dieser Wert "$Null", einer Windows PowerShell-Variablen, die einen Nullwert repräsentiert.

Um eine Auflistung von Benutzern zurückzugeben, denen eine VoIP-Richtlinie zugewiesen wurden, verwenden Sie diesen Befehl:

Get-CsUser -Filter {VoicePolicy -ne $Null}

-------------------------- Beispiel 6 --------------------------

Get-CsUser -LDAPFilter "Department=Finance"

Der vorstehende Befehl verwendet den Parameter "LDAPFilter", um die zurückgegebenen Daten auf Benutzer zu beschränken, die in der Abteilung "Finance" tätig sind. Dies wird durch Verwendung des LDAP-Filterwerts "Department=Finance" erreicht.

-------------------------- Beispiel 7 --------------------------

Get-CsUser -LDAPFilter "&(Department=Finance)(Title=Manager)"

In Beispiel 7 wird die Verwendung einer AND-Abfrage zusammen mit dem Parameter "LDAPFilter" veranschaulicht. Diese Abfrage (die eine AND-Abfrage durch das kaufmännische Und-Zeichen "&" repräsentiert) gibt zwei Bedingungen an: "Department=Finance" und "Title=Manager". Beide Bedingungen müssen erfüllt sein, damit diese Abfrage ein Benutzerkonto zurückgibt: ein Benutzer muss in der Abteilung "Finance" arbeiten und ein Manager sein.

-------------------------- Beispiel 8 --------------------------

Get-CsUser -LdapFilter "|(Title=Supervisor)(Title=Manager)"

Im Befehl in Beispiel 8 wird eine OR-Abfrage (am senkrechten Strich "|" zu erkennen) mit dem Parameter "LDAPFilter" verwendet. In der AND-Abfrage in Beispiel 7 mussten beide Bedingungen erfüllt sein, damit ein Benutzerkonto zurückgegeben wird. Bei einer OR-Abfrage muss nur eine Bedingung erfüllt sein, um das Konto zurückzugeben. In diesem Fall wird ein Benutzerkonto zurückgegeben, wenn der Benutzer ein Supervisor oder ein Manager ist.

-------------------------- Beispiel 9 --------------------------

Get-CsUser -OU "ou=Finance,ou=North America,dc=litwareinc,dc=com"

In Beispiel 9 werden Benutzerkontoinformationen zu allen Benutzern mit Konten in der OU "Finance" zurückgegeben.

-------------------------- Beispiel 10 --------------------------

Get-CsUser -UnassignedUser

Der vorstehende Befehl gibt eine Auflistung aller Benutzer zurück, die für Lync Server oder Office Communications Server aktiviert wurden, aber derzeit keinem Registrierungspool zugewiesen sind.