Artikel
01/16/2015

Get-CsUserPoolInfo

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen zu dem Registrierungspool, Sicherungsregistrierungspool und Benutzerdienstepool zurück, dem ein Benutzer zugewiesen ist.

Syntax

Get-CsUserPoolInfo -Identity <UserIdParameter> [-LocalStore <SwitchParameter>]

Detaillierte Beschreibung

Wenn ein Benutzer für Microsoft Lync Server 2010 aktiviert ist, muss er in einem Registrierungspool enthalten sein. Dieser Pool ist zuständig für die Authentifizierung des Benutzers und für die Nachverfolgung seines aktuellen Status und Standorts. Zum Abrufen des Registrierungspools, dem ein Benutzer zugewiesen wurde, können Sie einen Befehl wie den folgenden verwenden:

Get-CsUser "Ken Myer" | Select-Object RegistrarPool

In vielen Fällen werden neben dem Registrierungspool keine weiteren Informationen benötigt. In anderen Fällen möchten Sie jedoch möglicherweise zusätzliche Informationen abrufen, wie z. B. den Sicherungsregistrierungspool des Benutzers (den zu verwendenden Pool, wenn der primäre Registrierungspool nicht verfügbar ist), die Namen der einzelnen Computer innerhalb des Pools oder den Benutzerdienstepool, dem der Benutzer zugewiesen wurde. Diese ausführlichen Informationen können über das Cmdlet Get-CsUserPoolInfo zurückgegeben werden.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Get-CsUserPoolInfo lokal ausführen: 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-CsUserPoolInfo"}

Parameter

Parameter	Erforderlich	Typ	Beschreibung
Identity	Erforderlich	Benutzer-ID	Gibt die Identität des Benutzers an, dessen Benutzerpoolinformationen abgerufen werden sollen. Identitä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-Domänendienste (AD DS)-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 Informationen für Benutzer zurück, deren Nachname auf den Zeichenfolgenwert " Smith" endet.
LocalStore		Switch-Parameter	Ruft die Benutzerpoolinformationen aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Identity

Erforderlich

Benutzer-ID

Gibt die Identität des Benutzers an, dessen Benutzerpoolinformationen abgerufen werden sollen. Identitä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-Domänendienste (AD DS)-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 Informationen für Benutzer zurück, deren Nachname auf den Zeichenfolgenwert " Smith" endet.

LocalStore

Switch-Parameter

Ruft die Benutzerpoolinformationen aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Zeichenfolge oder Microsoft.Rtc.Management.ADConnect.Schema.ADUser-Objekt. Set-CsUser akzeptiert einen weitergeleiteten Zeichenfolgenwert, der die Eigenschaft "SamAccountName" eines für Lync Server 2010 aktivierten Benutzers darstellt. Das Cmdlet akzeptiert auch weitergeleitete Instanzen des Active Directory-Benutzerobjekts.

Rückgabetypen

Mit Get-CsUserPoolInfo werden Instanzen des Objekts "Microsoft.Rtc.Management.Xds.GetOCsUserPoolInfoCmdlet+UserInformation" zurückgegeben.

Beispiel

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

Get-CsUserPoolInfo "sip:kenmyer@litwareinc.com"

Mit dem vorstehenden Befehl werden Benutzerpoolinformationen für einen einzelnen Benutzer zurückgegeben: den Benutzer mit der SIP-Adresse "sip:kenmyer@litwareinc.com".

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

Get-CsUser | Get-CsUserPoolInfo

In Beispiel 2 werden Benutzerpoolinformationen für alle Benutzer zurückgegeben, die für Lync Server 2010 aktiviert wurden. Hierzu ruft der Befehl zunächst Get-CsUser ohne Parameter auf, um eine Auflistung aller Benutzer zurückzugeben, die für Lync Server aktiviert sind. Diese Auflistung wird dann an das Cmdlet Get-CsUserPoolInfo weitergeleitet, das die Poolinformationen für jeden Benutzer in der Auflistung anzeigt.

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

Get-CsUser | Where-Object {$_.RegistrarPool -ne $Null} | Get-CsUserPoolInfo

Der Befehl in Beispiel 3 ist eine Variante des Befehls in Beispiel 2. In Beispiel 2 werden Poolinformationen für alle Benutzer zurückgegeben, die für Lync Server aktiviert sind. Es kann jedoch Benutzer geben, die für Lync Server aktiviert sind, denen jedoch kein Registrierungspool zugewiesen wurde. Der Befehl in Beispiel 2 zeigt für jeden Benutzer eine Fehlermeldung an, der diesen Kriterien entspricht. Diese Fehlermeldungen werden in Beispiel 3 unterdrückt.

Zum Unterdrücken der Fehlermeldung gibt Beispiel 3 über das Cmdlet Get-CsUser erneut eine Auflistung aller für Lync Server aktivierten Benutzer zurück. In diesem Beispiel wird die Auflistung jedoch an das Cmdlet Where-Object weitergeleitet, das nur die Benutzer auswählt, bei denen die Eigenschaft "RegistrarPool" keinen Nullwert aufweist. (Anders ausgedrückt: Es werden Benutzer ausgewählt, denen ein Registrierungspool zugewiesen wurde.) Diese gefilterte Auflistung wird dann an das Cmdlet Get-CsUserPoolInfo weitergeleitet, das die Poolinformationen für jeden Benutzer in der gefilterten Auflistung anzeigt.

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

Get-CsUser | Get-CsUserPoolInfo | Where-Object {$_.PrimaryPoolFqdn -eq "redmond-cs-001.litwareinc.com"}

Mit dem vorstehenden Befehl werden Poolinformationen für alle Benutzer angezeigt, denen der primäre Pool "redmond-cs-001.litwareinc.com" zugewiesen wurde. Hierzu wird Get-CsUser aufgerufen, um eine Auflistung aller Benutzer zurückzugeben, die für Lync Server aktiviert sind. Diese Auflistung wird an das Cmdlet Get-CsUserPoolInfo weitergeleitet, das Poolinformationen für jeden Benutzer in der Auflistung abruft. Diese Poolinformationen werden an das Cmdlet Where-Object weitergeleitet, um nur die Benutzer auszuwählen, deren Eigenschaft "PrimaryPoolFqdn" den Wert "redmond-cs-001.litwareinc.com" aufweist.

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

Get-CsUser | Get-CsUserPoolInfo | Where-Object {$_.BackupPoolFqdn -eq $Null}

Der Befehl in Beispiel 5 gibt Poolinformationen für alle Benutzer zurück, denen kein Sicherungsregistrierungspool zugewiesen wurde. Hierzu wird zunächst Get-CsUser aufgerufen, um eine Auflistung aller Benutzer zurückzugeben, die für Lync Server aktiviert sind. Diese Informationen werden anschließend an das Cmdlet Get-CsUserPoolInfo weitergeleitet, das Poolinformationen für jeden Benutzer in der Auflistung abruft. Diese Poolinformationen werden schließlich an das Cmdlet Where-Object weitergeleitet, das nur für diejenigen Benutzer Daten anzeigt, deren Eigenschaft "BackupPoolFqdn" einen Nullwert aufweist.

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

Get-CsUserPoolInfo "Ken Myer" | Select-Object -Expand PrimaryPoolMachinesInPreferredOrder

In Beispiel 6 werden die Informationen zu den einzelnen Computern angezeigt, aus denen sich der Registrierungspool von "Ken Myer" zusammensetzt. Zum Abrufen dieser Informationen wird zunächst Get-CsUserPoolInfo aufgerufen, um die relevanten Daten für das Benutzerkonto von Ken Myer zurückzugeben. Diese Daten wird anschließend an das Cmdlet Select-Object weitergeleitet. Select-Object verwendet den Parameter "Expand" zum Erweitern von Informationen, die in der Eigenschaft "PrimaryPoolMachinesInPreferredOrder" gespeichert sind. Beim Erweitern einer Eigenschaft werden alle in dieser Eigenschaft gespeicherten Werte in benutzerfreundlicher Form auf dem Bildschirm angezeigt.

Freigeben über