Enable-UMMailbox

  • Artikel

 

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

Letztes Änderungsdatum des Themas: 2007-09-27

Das Cmdlet Enable-UMMailbox aktiviert Unified Messaging (UM) für einen vorhandenen E-Mail-aktivierten Benutzer.

Syntax

Enable-UMMailbox -Identity <MailboxIdParameter> -UMMailboxPolicy <MailboxPolicyIdParameter> [-AutomaticSpeechRecognitionEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Extensions <MultiValuedProperty>] [-IgnoreDefaultScope <SwitchParameter>] [-NotifyEmail <String>] [-PilotNumber <String>] [-Pin <String>] [-PinExpired <$true | $false>] [-SIPResourceIdentifier <String>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Das Cmdlet Enable-UMMailbox aktiviert Unified Messaging (UM) für einen vorhandenen E-Mail-aktivierten Microsoft Exchange Server 2007-Benutzer. Wenn der E-Mail-aktivierte Benutzer für Unified Messaging aktiviert wurde, werden die Einstellungen aus einer UM-Postfachrichtlinie auf den Benutzer angewendet. Wenn ein Benutzer für Unified Messaging aktiviert ist, kann er die in Exchange 2007 enthaltenen UM-Funktionen verwenden.

Damit Sie das Cmdlet Enable-UMMailbox 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 Exchange 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

  • Domain\Account

  • UPN

  • LegacyExchangeDN

  • SmtpAddress

  • Alias

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

UMMailboxPolicy

Erforderlich

Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter

Dieser Parameter gibt den Namen der Unified Messaging-Postfachrichtlinie an, die dem Benutzer zugeordnet werden soll.

AutomaticSpeechRecognitionEnabled

Optional

System.Boolean

Dieser Parameter aktiviert die automatische Spracherkennung (Automatic Speech Recognition, ASR) für die Verwendung mit dem UM-Postfach. ASR steht nur zur Verfügung, wenn die vom Benutzer angegebene Sprachpräferenz installiert ist.

Confirm

Optional

System.Management.Automation.SwitchParameter

Dieser Parameter bewirkt eine Unterbrechung der Befehlsausführung und zwingt den Administrator, 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 des Domänencontrollers an, der diese Konfigurationsänderung in den Active Directory-Verzeichnisdienst schreibt.

Extensions

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Dieser Parameter gibt die Durchwahlnummer für den Benutzer an. Entweder eine einzelne Durchwahlnummer oder ein Array von Durchwahlnummern kann angegeben werden. Die Durchwahl des Benutzers muss im UM-Wählplan eindeutig sein. Wenn dieser Parameter nicht mit aufgenommen wird, wird ein Standardwert aus Active Directory als Telefonnummer verwendet.

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 Parameters IgnoreDefaultScope bringt die folgenden Einschränkungen mit sich:

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

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

NotifyEmail

Optional

System.String

Dieser Parameter gibt die E-Mail-Adresse an, an die der Server die E-Mail-Nachricht mit den Willkommeninformationen von Unified Messaging senden soll. Standardmäßig wird die Nachricht an die SMTP-Adresse (Simple Mail Transfer Protocol) des aktivierten Benutzers gesendet.

PilotNumber

Optional

System.String

Dieser Parameter gibt die Teilnehmerzugriffsnummer an, die ein Benutzer wählen kann, um Zugriff auf sein Postfach zu erhalten. Der Standardwert ist die Teilnehmerzugriffsnummer, die auf einem Wählplanobjekt in Active Directory angegeben ist.

PIN

Optional

System.String

Dieser Parameter gibt den Wert für die PIN an, die anfänglich für das UM-Postfach verwendet wird. Die PIN wird anhand der Werte der UM-Postfachrichtlinien überprüft. Der PIN-Wert muss zwischen 4 und 24 numerische Zeichen aufweisen. Wenn keine PIN angegeben wird, wird dem Benutzer eine vom System generierte PIN per E-Mail zugesandt. Die vom System generierte PIN enthält standardmäßig 6 numerische Zeichen.

PINExpired

Optional

System.Boolean

Dieser Parameter gibt an, ob die PIN als abgelaufen behandelt wird. Wenn dieser Parameter angegeben und auf $false festgelegt ist, muss der Benutzer seine PIN bei der nächsten Anmeldung nicht zurücksetzen. Wenn die PIN nicht angegeben ist, wird die PIN als abgelaufen behandelt, und der Benutzer wird aufgefordert, seine PIN bei der nächsten Anmeldung zurückzusetzen.

SIPResourceIdentifier

Optional

System.String

Dieser Parameter gibt die SIP-Adresse (Session Initiation Protocol) oder die E.164-Adresse für den Benutzer an. Diese Eigenschaft wird mit dem URI-Typ (Uniform Resource Identifier) verglichen, der für den UM-Wählplan definiert ist.

ValidateOnly

Optional

System.Management.Automation.SwitchParameter

Dieser Parameter legt die Überprüfung aller erforderlichen Voraussetzungen fest, die für die erfolgreiche Ausführung des Cmdlets erforderlich sind, ohne eine Aktion auszuführen.

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 Parameters WhatIf kann der Administrator die resultierenden Änderungen anzeigen, ohne diese Änderungen tatsächlich auszuführen. Der Standardwert lautet "$true".

Eingabetypen

Typ Beschreibung

 

 

Rückgabetypen

Typ Beschreibung

 

 

Fehler

Fehler Beschreibung

 

 

Beispiel

Im ersten Beispiel wird Unified Messaging für das Postfach für yanli@contoso.com aktiviert, die Erweiterung und PIN für den Benutzer werden festgelegt und dann wird dem Postfach des Benutzers eine UM-Postfachrichtlinie mit dem Namen MyUMMailboxPolicy zugeordnet.

Im zweiten Beispiel wird Unified Messaging für ein SIP-aktiviertes Postfach für yanli@contoso.com aktiviert, eine UM-Postfachrichtlinie mit dem Namen MYUMMailboxPolicy wird zugeordnet und eine Durchwahl, SIP und PIN werden für den Benutzer festgelegt.

Enable-UMMailbox -Identity yanli@contoso.com -UMMailboxPolicy MyUMMailboxPolicy -Extensions 51234 -PIN 5643892 -NotifyEmail administrator@contoso.com -PINExpired $true

Enable-UMMailbox -Identity yanli@contoso.com -UMMailboxPolicy MyUMMailboxPolicy -Extensions 51234 -PIN 5643892 -NotifyEmail administrator@contoso.com -SIPResourceIdentifier "yanli@contoso.com" -PINExpired $true