Set-UMMailboxPIN (RTM)
Gilt für: Exchange Server 2007
Letztes Änderungsdatum des Themas: 2007-06-11
Das Cmdlet Set-UMMailboxPIN setzt die PIN für ein UM-aktiviertes Postfach zurück.
Syntax
Set-UMMailboxPIN -Identity <MailboxIdParameter> [-DomainController <Fqdn>] [-LockedOut <$true | $false>] [-NotifyEmail <String>] [-Pin <String>] [-PinExpired <$true | $false>]
Detaillierte Beschreibung
Das Cmdlet Set-UMMailboxPIN wird verwendet, wenn ein UM-aktivierter Benutzer aus seinem Postfach ausgesperrt wurde, weil mehrere Male versucht wurde, sich mit einer fehlerhaften PIN anzumelden bzw. weil die PIN vergessen wurde. Mithilfe dieses Cmdlets können Sie die PIN des Benutzers festlegen. Die neue PIN muss die Regeln der PIN-Richtlinie einhalten, die durch die Postfachrichtlinie des Benutzers festgelegt sind. Die neue PIN wird per E-Mail an den Benutzer oder an eine alternative E-Mail-Adresse gesendet. Sie können steuern, ob der Benutzer seine PIN bei der Anmeldung zurücksetzen muss und ob das Postfach gesperrt bleibt.
Damit Sie das Cmdlet Set-UMMailboxPIN ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:
- die Rolle Exchange-Empfängeradministrator
Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Exchange Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
Dieser Parameter gibt den für Unified Messaging zu aktivierenden Benutzer an. Zu den Variablen für diesen Parameter gehören die folgenden:
Dieser Parameter ist erforderlich, wenn der Parameter Instance nicht verwendet wird. |
DomainController |
Optional |
.Exchange.Data.Fqdn |
Um den vollqualifizierten Domänennamen des Domänencontrollers anzugeben, der diese Konfigurationsänderung in den Active Directory-Verzeichnisdienst schreibt, fügen Sie dem Cmdlet den Parameter DomainController hinzu. |
LockedOut |
Optional |
System.Boolean |
Dieser Parameter gibt an, ob das Postfach weiterhin gesperrt bleiben soll. Wenn dieser Parameter auf |
NotifyEmail |
Optional |
System.String |
Dieser Parameter gibt die E-Mail-Adresse an, an die der Server die E-Mail-Nachricht mit den Informationen zum Zurücksetzen der PIN senden soll. Standardmäßig wird die Nachricht an die SMTP-Adresse des aktivierten Benutzers gesendet. |
Pin |
Optional |
System.String |
Dieser Parameter gibt eine neue PIN zur Verwendung mit diesem Postfach an. Die PIN wird hinsichtlich der PIN-Regeln überprüft, die in der UM-Richtlinie definiert sind. Wenn die PIN nicht angegeben wird, generiert der Task eine neue PIN für das Postfach und fügt diese in eine E-Mail-Nachricht ein, die an den Benutzer gesendet wird. |
PINExpired |
Optional |
System.Boolean |
Dieser Parameter gibt an, ob die PIN als abgelaufen behandelt wird. Wenn dieser Parameter angegeben und auf |
Eingabetypen
Rückgabetypen
Fehler
| Fehler | Beschreibung |
|---|---|
|
|
Beispiel
Das erste Beispiel setzt die PIN für ein UM-aktiviertes Postfach des Benutzers yanli@contoso.com zurück.
Das zweite Beispiel setzt die PIN für ein UM-aktiviertes Postfach des Benutzers yanli@contoso.com auf 1985848 und setzt die PIN dann als abgelaufen fest, sodass der Benutzer aufgefordert wird, die PIN bei der nächsten Anmeldung zu ändern.
Das dritte Beispiel sperrt das UM-aktivierte Postfach für den Benutzer yanli@contoso.com, um den Zugriff dieses Benutzers auf das Postfach zu verhindern.
Das vierte Beispiel hebt die Sperre des UM-aktivierten Postfachs für den Benutzer yanli@contoso.com auf und gewährt ihm Zugriff auf das Postfach.
Set-UMMailboxPIN -Identity yanli@contoso.com
Set-UMMailboxPIN -Identity yanli@contoso.com -PIN 1985848 -PinExpired $true
Set-UMMailboxPIN -Identity yanli@contoso.com -LockedOut $true
Set-UMMailboxPIN -Identity yanli@contoso.com -LockedOut $false