Get-UMMailboxPIN (RTM)

  • Artikel

 

Gilt für: Exchange Server 2007

Letztes Änderungsdatum des Themas: 2007-06-11

Das Cmdlet Get-UMMailboxPIN gibt Informationen aus dem Postfach eines UM-aktivierten Benutzers zurück.

Syntax

Get-UMMailboxPin [-Identity <MailboxIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-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 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

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

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.

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

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 Exchange-Server 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