Set-UMMailboxPIN

  • Artikel

 

Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Letztes Änderungsdatum des Themas: 2007-06-28

Das Cmdlet Set-UMMailboxPIN setzt die PIN für ein UM-aktiviertes (Unified Messaging) Postfach zurück.

Syntax

Set-UMMailboxPIN -Identity <MailboxIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-LockedOut <$true | $false>] [-NotifyEmail <String>] [-Pin <String>] [-PinExpired <$true | $false>] [-WhatIf [<SwitchParameter>]]

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 dem Konto die Rolle Exchange-Empfängeradministrator zugewiesen worden sein.

Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Microsoft 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:

  • ADObjectID

  • GUID

  • DN

  • Domäne\Konto

  • Benutzerprinzipalname (User Principal Name, UPN)

  • LegacyExchangeDN

  • SmtpAddress

  • Alias

Dieser Parameter ist erforderlich, wenn der Parameter Instance nicht verwendet wird.

Confirm

Optional

System.Management.Automation.SwitchParameter

Dieser Parameter bewirkt eine Unterbrechung der Befehlsausführung und zwingt den Benutzer, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Der Standardwert lautet "$true".

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Dieser Parameter gibt den vollqualifizierten Domänennamen (FQDN) des Domänencontrollers an, der diese Konfigurationsänderung in den Active Directory-Verzeichnisdienst schreibt.

IgnoreDefaultScope

Optional

System.Management.Automation.SwitchParameter

Mit diesem Parameter wird der Befehl angewiesen, die Standardeinstellung für den Empfängerbereich für die Exchange-Verwaltungsshell zu ignorieren und die ganze Gesamtstruktur als Bereich zu verwenden. Dadurch kann der Befehl auf Active Directory-Objekte zugreifen, die sich aktuell nicht im Standardbereich befinden. Die Verwendung des IgnoreDefaultScope-Parameters bringt die folgenden Einschränkungen mit sich:

  • Der DomainController-Parameter kann nicht verwendet werden. Der Befehl verwendet automatisch einen geeigneten globalen Katalogserver.

  • Für den Identity-Parameter kann nur der DN verwendet werden. Andere Formen der Identifikation, wie etwa Aliasnamen oder GUIDs, werden nicht akzeptiert.

LockedOut

Optional

System.Boolean

Dieser Parameter gibt an, ob das Postfach weiterhin gesperrt bleiben soll. Wenn dieser Parameter auf $true festgelegt wird, wird das Postfach als "gesperrt" gekennzeichnet. Wenn dieser Parameter ausgelassen oder auf $false festgelegt wird, entfernt der Task standardmäßig den "Gesperrt"-Status eines Postfachs.

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 werden soll. Wenn dieser Parameter angegeben und auf $false festgelegt wird, muss der Benutzer seine PIN bei der nächsten Anmeldung nicht zurücksetzen. Wenn dieser Parameter nicht angegeben wird, wird die PIN als abgelaufen behandelt und der Benutzer wird bei der nächsten Anmeldung aufgefordert, seine PIN zurückzusetzen.

WhatIf

Optional

System.Management.Automation.SwitchParameter

Dieser Parameter weist den Befehl an, die Aktionen zu simulieren, die für das Objekt ausgeführt würden. Durch Verwendung des WhatIf-Parameters können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Der Standardwert lautet "$true".

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