Set-CsClientPin
Letztes Änderungsdatum des Themas: 2012-03-25
Weist dem angegebenen Benutzer eine neue persönliche Identifikationsnummer (PIN) zu.
Syntax
Set-CsClientPin -Identity <UserIdParameter> [-Pin <String>] [-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.
Benutzern wird bei ihrer Aktivierung für Lync Server 2010 keine PIN zugewiesen, d. h., Benutzer können standardmäßig nicht per PIN-Authentifizierung auf das System zugreifen. Benutzer können eine PIN von der Webseite für Einwahlkonferenzen abrufen. Alternativ dazu können Administratoren jedem Benutzer mithilfe des Cmdlets Set-CsClientPin eine PIN zuweisen. Mit Set-CsClientPin können Sie entweder einem Benutzer eine bestimmte PIN zuweisen oder von Lync Server 2010 eine PIN generieren lassen. Um eine PIN automatisch zu generieren, lassen Sie beim Aufrufen von Set-CsClientPin einfach den Parameter "PIN" weg. In diesem Fall wird eine neue PIN generiert, und die Benutzeridentität und die neue PIN werden nach dem Ausführen des Befehls auf dem Bildschirm angezeigt.
Beachten Sie, dass explizit zugewiesene PINs den Bedingungen der PIN-Authentifizierungsrichtlinie entsprechen müssen, die für den betreffenden Benutzer gilt. Die PIN muss beispielsweise mindestens genauso viele Ziffern enthalten wie von der Eigenschaft "MinPasswordLength" angegeben. Beachten Sie außerdem, dass PINs nur Zahlen enthalten können. Buchstaben oder nicht numerische Zeichen sind nicht zulässig.
Wenn Sie mit Set-CsClientPin eine Client-PIN festlegen, wird der PIN-Verlaufszähler nicht erzwungen. Angenommen, die PIN eines Benutzers 12345 lautet, und er kann aufgrund der Client-PIN-Richtlinie nicht direkt wieder die gleiche PIN erneut verwenden. Wenn der Benutzer versucht, über die Webseite der Einwahlkonferenz seine Client-PIN zu erneuern, wird jeder derartige Versuch zurückgewiesen, wenn die gleiche PIN (12345) eingegeben wird. Wenn das Cmdlet Set-CsClientPin verwendet wird, kann ein Administrator diesem Benutzer jedoch die PIN 12345 zuweisen, da Set-CsClientPin nicht an den PIN-Richtlinienverlaufszähler gebunden ist.
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 Set-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 Set-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 Set-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 "Set-CsClientPin"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
UserIdParameter |
Identitätswert des Benutzerkontos, für das die PIN festgelegt 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. |
Pin |
Optional |
Ganze Zahl |
Optionale PIN, die dem Benutzer zugewiesen werden soll. Wenn Sie den Parameter "PIN" angeben, generiert Lync Server 2010 nach dem Zufallsprinzip eine PIN und weist diese dem betreffenden Benutzer zu. Beachten Sie, dass die PIN den Einstellungen für Mindestlänge und allgemeine Muster entsprechen muss, die in der dem Benutzer zugewiesenen Client-PIN-Richtlinie zu finden sind. |
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. Set-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
Set-CsClientPin gibt keine Werte oder Objekte zurück. Stattdessen konfiguriert das Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.UserPinService.PinInfoDetails".
Beispiel
-------------------------- Beispiel 1 ------------------------
Set-CsClientPin -Identity "litwareinc\kenmyer"
In Beispiel 1 wird dem Benutzer "litwareinc\kenmyer" eine neue, automatisch generierte PIN zugewiesen. Um eine automatisch generierte PIN zuzuweisen, lassen Sie beim Aufrufen von Set-CsClientPin einfach den Parameter "Pin" weg. Nachdem der Befehl ausgeführt wurde, wird die neue PIN, die Ken Myer zugewiesen wurde, auf dem Bildschirm angezeigt. Diese Informationen können dann an den Benutzer weitergegeben werden.
-------------------------- Beispiel 2 ------------------------
Set-CsClientPin -Identity "litwareinc\kenmyer" -Pin 18723834
Mit dem Befehl in Beispiel 2 wird dem Benutzer "litwareinc\kenmyer" die PIN 18723834 zugewiesen. Verwenden Sie den Parameter "Pin", gefolgt von der zuzuweisenden Nummer, um eine bestimmte PIN zuzuweisen.
-------------------------- Beispiel 3 ------------------------
Get-CsUser -OU "OU=Finance,DC=litwareinc,DC=com" | Set-CsClientPin
Beispiel 3 zeigt, wie Sie allen Benutzern in einer bestimmten Active Directory-Organisationseinheit (OU) automatisch neue PINs zuweisen können. Dazu wird mit Get-CsUser und dem Parameter "OU" eine Auflistung aller Benutzer mit einem Konto in der OU "Finance" zurückgegeben. Diese Auflistung wird anschließend an das Cmdlet Set-CsClientPin weitergeleitet, das für jeden Benutzer in der Auflistung eine neue PIN generiert.
-------------------------- Beispiel 4 ------------------------
Get-CsUser | Get-CsClientPinInfo | Where-Object {$_.IsPinSet -eq $False} | Set-CsClientPin
Der Befehl in Beispiel 4 weist allen Benutzern eine neue PIN zu, denen derzeit keine PIN zugewiesen ist. Dazu wird mit Get-CsUser eine Auflistung aller Benutzer zurückgegeben, die für Lync Server 2010 aktiviert sind. Diese Auflistung wird dann an die Cmdlets Get-CsClientPin und Where-Object weitergeleitet, die die Benutzer herausfiltern, bei denen die Eigenschaft "IsPinSet" den Wert "False" aufweist. Die resultierende Auflistung, die nur Benutzer ohne PIN enthält, wird dann an das Cmdlet Set-CsClientPin weitergeleitet, das automatisch eine PIN für jeden Benutzer in der Auflistung generiert.