Remove-CsPinPolicy

 

Letztes Änderungsdatum des Themas: 2012-03-27

Entfernt die angegebene PIN-Richtlinie (persönliche Identifikationsnummer). Die PIN-Authentifizierung und PIN-Richtlinien ermöglichen Benutzern den Zugriff auf Microsoft Lync Server 2010, indem sie anstelle eines Benutzernamens und eines Kennworts eine PIN eingeben.

Syntax

Remove-CsPinPolicy -Identity <XdsIdentity> [-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. Normalerweise erfordert die Anmeldung beim System oder der Beitritt zu einer Konferenz die Eingabe eines Benutzernamens oder Kennworts. Dies kann jedoch zu einem Problem werden, wenn Sie ein Telefon verwenden, das keine alphanumerischen Tasten hat. Daher können Sie mit Lync Server 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.

Lync Server verwendet PIN-Richtlinien, um Eigenschaften der PIN-Authentifizierung zu verwalten. Sie können beispielsweise die Mindestlänge für eine PIN festlegen und definieren, ob PINs mit "allgemeinen Mustern" zulässig sind, etwa auf- oder absteigende Zahlenfolgen (z. B. die PIN 123456). Zusätzlich zu der globalen PIN-Richtlinie, die bei der Installation von Lync Server 2010 für Sie erstellt wird, können Sie benutzerdefinierte PIN-Richtlinien zur Anwendung auf Standort- oder Benutzerebene anlegen.

Mit dem Cmdlet Remove-CsPinPolicy können Sie standort- oder benutzerbezogen konfigurierte PIN-Richtlinien entfernen. Bei Entfernen von standort- oder benutzerbasierten Richtlinien werden diese Richtlinien gelöscht, sodass sie nicht mehr zur Verfügung stehen. Darüber hinaus übernehmen Benutzer, denen diese Richtlinien zugewiesen waren, automatisch die nächste Richtlinie in der Richtlinienhierarchie (globale, Standort, Dienst, benutzerbasiert). Wenn Sie beispielsweise eine Standortrichtlinie entfernen, gilt für Benutzer, für die diese Richtlinie galt, die globale Richtlinie für die Verwaltung von PIN-Einstellungen.

Sie können das Cmdlet Remove-CsPinPolicy auch für die globale Richtlinie ausführen. In diesem Fall wird die Richtlinie jedoch nicht entfernt: Die globale Richtlinie kann nicht gelöscht werden. Stattdessen werden alle Eigenschaften in der globalen Richtlinie auf die Standardwerte zurückgesetzt. Angenommen, Sie haben die globale Richtlinie mit einer PIN-Mindestlänge von 11 Ziffern konfiguriert. Wenn Sie die globale Richtlinie entfernen, wird die PIN-Mindestlänge auf die Standardlänge (fünf Ziffern) zurückgesetzt.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Der eindeutige Identitätswert, der der Richtlinie beim Erstellen zugewiesen wurde. PIN-Richtlinien können auf globaler Ebene, auf Standortebene und auf Benutzerbasis konfiguriert werden. Verwenden Sie diese Syntax, um auf die globale Instanz zu verweisen: -Identity global. Verwenden Sie diese Syntax, um auf eine Richtlinie auf Standortebene zu verweisen: -Identity site:Redmond. Verwenden Sie eine Syntax wie die folgende, um auf eine benutzerbasierte Richtlinie zu verweisen: -Identity RedmondPINPolicy.

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

Microsoft.Rtc.Management.WritableConfig.Policy.UserPin.UserPolicy-Objekt. Das Cmdlet Remove-CsPinPolicy akzeptiert eine weitergeleitete Eingabe des PIN-Richtlinienobjekts.

Rückgabetypen

Remove-CsPinPolicy gibt keine Werte oder Objekte zurück. Stattdessen entfernt das Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Policy.UserPin.UserPolicy".

Beispiel

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

Remove-CsPinPolicy -Identity RedmondUsersPinPolicy

Mit dem vorstehenden Befehl wird die benutzerbezogene PIN-Richtlinie mit dem Identitätswert "RedmondUsersPinPolicy" entfernt.

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

Get-CsPinPolicy -Filter "site:*" | Remove-CsPinPolicy

Mit dem Befehl in Beispiel 2 werden alle PIN-Richtlinien entfernt, die auf Standortebene konfiguriert wurden. Hierzu wird das Cmdlet Get-CsPinPolicy mit dem Parameter "Filter" aufgerufen, um eine Auflistung aller Richtlinien zurückzugeben, deren Identitätswert mit der Zeichenfolge "site:" beginnt. Diese Auflistung wird dann an das Cmdlet Remove-CsPinPolicy weitergeleitet, das jede Richtlinie in der Auflistung löscht.

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

Get-CsPinPolicy | Where-Object {$_.AllowCommonPatterns -eq $True} | Remove-CsPinPolicy

In Beispiel 3 dienen Get-CsPinPolicy, Where-Object und Remove-CsPinPolicy zum Löschen aller PIN-Richtlinien, bei denen die Eigenschaft "AllowCommonPatterns" auf "True" festgelegt ist. Hierzu wird zunächst mit Get-CsPinPolicy eine Auflistung aller PIN-Richtlinien zurückgegeben, die für die Verwendung in dieser Organisation konfiguriert wurden. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur die Richtlinien herausfiltert, bei denen die Eigenschaft "AllowCommonPatterns" den Wert "True" aufweist. Diese gefilterte Auflistung wird schließlich an das Cmdlet Remove-CsPinPolicy weitergeleitet, das jede Richtlinie in der Auflistung löscht.

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

Get-CsPinPolicy | Remove-CsPinPolicy

Der Befehl in Beispiel 4 löscht alle auf Benutzer- und Standortebene konfigurierten PIN-Richtlinien. Hierzu wird mit Get-CsPinPolicy eine Auflistung aller in der Organisation konfigurierten PIN-Richtlinien zurückgegeben. Diese Auflistung wird dann an Remove-CsPinPolicy weitergeleitet. Beachten Sie, dass auch die globale Richtlinie in dieser Auflistung enthalten ist. Diese wird jedoch nicht gelöscht. Stattdessen werden alle Eigenschaften in der globalen Richtlinie auf die Standardwerte zurückgesetzt.