Get-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 Get-UMMailboxPIN gibt Informationen aus dem Postfach eines UM-aktivierten Benutzers zurück.

Syntax

Get-UMMailboxPin [-Identity <MailboxIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>]

Detaillierte Beschreibung

Das Cmdlet Get-UMMailboxPIN gibt Informationen zurück, die anhand der PIN-Daten berechnet werden, die in verschlüsselter Form im Postfach des Benutzers gespeichert sind. Mithilfe des Cmdlets Get-UMMailboxPIN können Sie Informationen aus dem Postfach des Benutzers anzeigen. Das Cmdlet kann auch verwendet werden, um anzuzeigen, ob der Zugang für das Postfach oder den Benutzer gesperrt ist.

Damit Sie das Cmdlet Get-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

Credential

Optional

System.Management.Automation.PSCredential

Dieser Parameter gibt den zu verwendenden Benutzernamen und das Kennwort für den Zugriff auf den Active Directory-Verzeichnisdienst an.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

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

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Dieser Parameter legt den Bezeichner fest, der verwendet werden kann, um Informationen über das Postfach abzurufen. Zu den Variablen für diesen Parameter gehören die folgenden:

  • ADObjectID

  • GUID

  • DN

  • Domäne\Konto

  • UPN

  • LegacyExchangeDN

  • SmtpAddress

  • Alias

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 Aliase oder GUIDs, werden nicht akzeptiert.

  • Die Parameter OrganizationalUnit und Identity können nicht zusammen verwendet werden.

  • Der Credential-Parameter kann nicht verwendet werden.

ReadFromDomainController

Optional

System.Management.Automation.SwitchParameter

Dieser Parameter legt fest, dass die Benutzerinformationen von einem Domänencontroller in der Domäne des Benutzers abgerufen werden. Wenn Sie festgelegt haben, dass der Empfängerbereich alle Empfänger in der Gesamtstruktur enthalten soll, und Sie diesen Parameter nicht verwenden, werden die Benutzerinformationen möglicherweise aus einem globalen Katalog mit veralteten Informationen abgerufen. Wenn Sie diesen Parameter verwenden, sind zum Abrufen der Informationen möglicherweise mehrere Lesevorgänge erforderlich. Standardmäßig ist der Empfängerbereich auf die Domäne festgelegt, in der sich Ihre Server mit Exchange befinden.

ResultSize

Optional

Microsoft.Exchange.Data.Unlimited

Dieser Parameter gibt die maximale Anzahl von Ergebnissen an, die zurückgegeben werden. Wenn kein Höchstwert angegeben wird, gibt das Cmdlet alle Ergebnisse zurück.

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

 

 

Ausnahmen

Ausnahmen Beschreibung

 

 

Beispiel

Das erste Codebeispiel zeigt die PIN-Eigenschaften des Unified Messaging-Postfachs für alle UM-aktivierten Benutzer an.

Das zweite Codebeispiel zeigt die zu der PIN des Unified Messaging-Postfachs gehörenden Eigenschaften für yanli@contoso.com an.

Get-UMMailboxPIN

Get-UMMailboxPIN -Identity yanli@contoso.com