Get-CsClientPinInfo
Letztes Änderungsdatum des Themas: 2012-03-23
Ruft Informationen zur persönlichen Identifikationsnummer (PIN) ab, die einem Benutzer zugewiesen ist.
Syntax
Get-CsClientPinInfo -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Lync Server 2010 ermöglicht es den Benutzern, eine Verbindung mit dem System herzustellen oder per Telefon an Konferenzen über das Telefonfestnetz (Public Switched Telephone Network, PSTN) teilzunehmen. Üblicherweise ist für die Anmeldung beim System oder für den Beitritt zu einer Konferenz die Eingabe eines Benutzernamens oder Kennworts erforderlich. Die Eingabe eines Benutzernamens oder Kennworts kann jedoch zu einem Problem werden, wenn Sie ein Telefon verwenden, das keine alphanumerischen Tasten umfasst. Daher können Sie mit Lync Server 2010 den Benutzern ausschließlich aus Zahlen bestehende PINs zur Verfügung stellen. Benutzer können sich dann nach Aufforderung beim System anmelden oder einer Konferenz beitreten, indem sie anstelle eines Benutzernamens und Kennworts eine PIN eingeben.
Administratoren können die PIN-Einstellungen für einen Benutzer oder eine Benutzergruppe abrufen, indem Sie das Cmdlet Get-CsClientPinInfo ausführen. Beachten Sie, dass ein Administrator nicht die Möglichkeit hat, bereits zugewiesene PINs der Benutzer abzurufen. Wenn ein Benutzer seine PIN vergisst, kann er nicht mithilfe der PIN-Authentifizierung auf das System zugreifen. Dies ist erst wieder möglich, wenn ein Administrator ihm eine neue PIN zugewiesen hat oder der Benutzer eine neue PIN von der Webseite für Einwahlkonferenzen abgerufen hat.
Beachten Sie, dass die Firewallausnahmen für SQL Server Express standardmäßig nicht aktiviert sind, wenn Sie die Standard Edition von Lync Server 2010 installieren. Dies bedeutet, dass Sie das Cmdlet Get-CsClientPinInfo nicht über eine Remoteinstanz von Windows PowerShell ausführen können. Der Grund hierfür ist, dass der Befehl die Firewall nicht passieren kann und somit kein Zugriff auf die SQL Server Express-Datenbank möglich ist. (Sie können das Cmdlet jedoch weiterhin lokal auf dem Standard Edition-Server ausführen.) Um das Cmdlet Get-CsClientPinInfo remote auf einem Standard Edition-Server auszuführen, müssen Sie die Firewallausnahmen für SQL Server Express manuell aktivieren.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Get-CsClientPinInfo lokal auszuführen: RTCUniversalServerAdmins. 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-CsClientPinInfo"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
UserId-Parameter |
Gibt den Identitätswert des Benutzerkontos an, für das die PIN gesperrt 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. |
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
Zeichenfolgenwert oder Microsoft.Rtc.Management.ADConnect.Schema.ADUser-Objekt. Get-CsClientPinInfo akzeptiert eine weitergeleitete Eingabe von Zeichenfolgenwerten, die den Identitätswert eines Benutzerkontos repräsentieren. Das Cmdlet akzeptiert auch eine weitergeleitete Eingabe von Benutzerobjekten.
Rückgabetypen
Mit Get-CsClientPinInfo wird mindestens eine Instanz des Objekts "Microsoft.Rtc.Management.UserPinService.PinInfoDetails" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 ------------------------
Get-CsUser | Get-CsClientPinInfo
Mit dem vorstehenden Befehl werden PIN-Informationen zu allen Benutzern zurückgegeben, die für Lync Server 2010 aktiviert wurden. Hierzu ruft der Befehl zunächst Get-CsUser auf, um alle für Lync Server 2010 aktivierten Benutzer zurückzugeben. Diese Auflistung wird dann an das Cmdlet Get-CsClientPinInfo weitergeleitet, das die PIN-Informationen für jeden Benutzer in der Auflistung anzeigt.
-------------------------- Beispiel 2 ------------------------
Get-CsClientPinInfo -Identity "litwareinc\kenmyer"
In Beispiel 2 werden mit Get-CsClientPinInfo die PIN-Informationen eines einzelnen Benutzers angezeigt: des Benutzers mit dem Identitätswert "litwareinc\kenmyer".
-------------------------- Beispiel 3 ------------------------
Get-CsUser -OU "OU=Finance,DC=litwareinc,DC=com" | Get-CsClientPinInfo
In Beispiel 3 werden PIN-Informationen zu allen Benutzern mit Konten in der Organisationseinheit (OU) "Finance" zurückgegeben. Hierzu wird zunächst mit Get-CsUser und dem Parameter "OU" eine Auflistung aller Benutzer in der OU "Finance" zurückgegeben. Diese Auflistung wird dann an das Cmdlet Get-CsClientPinInfo weitergeleitet, das die PIN-Informationen für jeden Benutzer in der Auflistung anzeigt.
-------------------------- Beispiel 4 ------------------------
Get-CsUser -LdapFilter "Title=Manager" | Get-CsClientPinInfo
Der Befehl in Beispiel 4 zeigt PIN-Informationen für alle Manager in der Organisation an. Der Befehl ruft mit Get-CsUser und dem Parameter "LdapFilter" eine Auflistung aller Manager ab. Der Filter "Title=Manager" schränkt die zurückgegebene Auflistung auf Benutzer ein, deren Position "Manager" lautet. Anschließend werden mit Get-CsClientPinInfo PIN-Informationen für jeden dieser Benutzer angezeigt.