Unlock-CsClientPin
Letztes Änderungsdatum des Themas: 2012-03-24
Ermöglicht einem Administrator das Entsperren der persönlichen Identifikationsnummer (PIN) für einen angegebenen Benutzer.
Syntax
Unlock-CsClientPin -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-Force <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.
Dies gilt jedoch nur, wenn die PIN des Benutzers nicht gesperrt ist. Wurde eine PIN gesperrt (weil der Benutzer sich wiederholt nicht anmelden konnte oder weil ein Administrator die PIN explizit gesperrt hat), kann der Benutzer nicht über die PIN-Authentifizierung auf das System zugreifen oder an Konferenzen teilnehmen. (Der Benutzer kann jedoch nach wie vor eine Anwendung wie Microsoft Lync 2010 für die Anmeldung beim System verwenden, indem er einen Benutzernamen und ein Kennwort angibt.) Wurde eine PIN gesperrt, gibt es nur eine Möglichkeit, dem Benutzer den Zugriff auf das System über die PIN-Authentifizierung wieder zu ermöglichen: Die PIN-Sperre muss von einem Administrator aufgehoben werden. Die Entsperrung kann mit dem Cmdlet Unlock-CsClientPin durchgeführt werden.
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 Unlock-CsClientPin 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 selbst ausführen.) Um das Cmdlet Unlock-CsClientPin 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 dürfen Mitglieder der folgenden Gruppen das Cmdlet Unlock-CsClientPin lokal ausfü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 "Unlock-CsClientPin"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
UserIdParameter |
Identitätswert des Benutzerkontos, für das die PIN entsperrt werden soll. Benutzeridentitäten können in den folgenden vier Formaten angegeben werden: 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) Active Directory-Anzeigename des Benutzers (z. B. "Ken Myer"). Benutzeridentitäten können auch über den Active Directory-DN (Distinguished Name) des Benutzers referenziert werden. Ferner können Sie das Sternchen (*) als Platzhalterzeichen verwenden, 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. |
Force |
Optional |
Switch-Parameter |
Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können. |
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. Unlock-CsClientPin 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
Unlock-CsClientPin gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WriteableConfig.Voice.VoicePolicy" konfiguriert.
Beispiel
-------------------------- Beispiel 1 ------------------------
Unlock-CsClientPin -Identity "litwareinc\kenmyer"
In Beispiel 1 wird Unlock-CsClientPin zum Aufheben der PIN-Sperre für den Benutzer "litwareinc\kenmyer" verwendet.
-------------------------- Beispiel 2 ------------------------
Get-CsUser | Get-CsClientPinInfo | Where-Object {$_.IsLockedOut -eq $True} | Unlock-CsClientPin
Im vorstehenden Beispiel wird Unlock-CsClientPin zum Entsperren aller derzeit gesperrten PINs verwendet. Hierzu wird zunächst Get-CsUser aufgerufen, um eine Auflistung aller Benutzer zurückzugeben, die für Lync Server 2010 aktiviert sind. Die Auflistung wird dann an das Cmdlet Get-CsClientPinInfo weitergeleitet, das mit dem Cmdlet Where-Object eingesetzt wird, um nur diejenigen Benutzer herauszufiltern, bei denen die Eigenschaft "IsLockedOut" den Wert "True" ($True) aufweist (der Vergleichsoperator "-eq" steht für "equal to").
Diese gefilterte Auflistung wird dann an das Cmdlet Unlock-CsClientPin weitergeleitet, das die gesperrten PINs der einzelnen Benutzer entsperrt.