Set-UMMailbox

  • Artikel

 

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

Letztes Änderungsdatum des Themas: 2009-05-13

Das Cmdlet Set-UMMailbox legt die Unified Messaging-Eigenschaften (UM) für einen Benutzer fest, der zurzeit UM-aktiviert ist.

Syntax

Set-UMMailbox -Identity <MailboxIdParameter> [-AllowUMCallsFromNonUsers <None | SearchEnabled>] [-AnonymousCallersCanLeaveMessages <$true | $false>] [-AutomaticSpeechRecognitionEnabled <$true | $false>] [-CallAnsweringAudioCodec <G711 | Wma | Gsm>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FaxEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-MissedCallNotificationEnabled <$true | $false>] [-Name <String>] [-OperatorNumber <String>] [-SubscriberAccessEnabled <$true | $false>] [-TUIAccessToAddressBookEnabled <$true | $false>] [-TUIAccessToCalendarEnabled <$true | $false>] [-TUIAccessToEmailEnabled <$true | $false>] [-UMMailboxPolicy <MailboxPolicyIdParameter>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Set-UMMailbox [-AllowUMCallsFromNonUsers <None | SearchEnabled>] [-AnonymousCallersCanLeaveMessages <$true | $false>] [-AutomaticSpeechRecognitionEnabled <$true | $false>] [-CallAnsweringAudioCodec <G711 | Wma | Gsm>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FaxEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-Instance <UMMailbox>] [-MissedCallNotificationEnabled <$true | $false>] [-Name <String>] [-OperatorNumber <String>] [-SubscriberAccessEnabled <$true | $false>] [-TUIAccessToAddressBookEnabled <$true | $false>] [-TUIAccessToCalendarEnabled <$true | $false>] [-TUIAccessToEmailEnabled <$true | $false>] [-UMMailboxPolicy <MailboxPolicyIdParameter>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Mithilfe des Cmdlets Set-UMMailbox können Sie UM-Eigenschaften festlegen, die einem Benutzer zugeordnet sind, der UM-aktiviert wurde. Zahlreiche der UM-Eigenschaften des Benutzers werden in seinem Postfach gespeichert, andere seiner UM-Eigenschaften werden dagegen im Active Directory-Verzeichnisdienst gespeichert. Mit diesem Cmdlet können UM-Eigenschaften einzeln festgelegt werden, wenn einer der beiden Parameter Identity oder Instance verwendet wird.

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

AllowUMCallsFromNonUsers

Optional

Microsoft.Exchange.Data.Directory.Recipient.AllowUMCallsFromNonUsersFlags

Dieser Parameter gibt an, ob das Postfach von Verzeichnissuchen ausgeschlossen werden soll.

AnonymousCallersCanLeaveMessages

Optional

System.Boolean

Dieser Parameter gibt an, ob umgeleitete Anrufe ohne eine Anrufer-ID eine Nachricht hinterlassen dürfen.

AutomaticSpeechRecognitionEnabled

Optional

System.Boolean

Dieser Parameter gibt an, ob der Benutzer ASR (Automatic Speech Recognition, automatische Spracherkennung) verwenden kann, wenn er sich an deinem Postfach anmeldet. Dieser Parameter kann nur auf $true festgelegt werden, wenn für die vom Benutzer in den Outlook Web Access-Optionen ausgewählte Sprache ASR-Unterstützung vorhanden ist.

CallAnsweringAudioCodec

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.AudioCodecEnum

Dieser Parameter gibt den Audiocodec an, der für Anrufannahmenachrichten verwendet werden soll. Der Standardwert für das Postfach eines Benutzers ist der im UM-Wählplan konfigurierte Audiocodec.

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".

DisplayName

Optional

System.String

Dieser Parameter gibt den Anzeigenamen für den Benutzer 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.

FaxEnabled

Optional

System.Boolean

Dieser Parameter gibt an, ob ein Benutzer eingehende Faxe erhalten darf.

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.

Instance

Optional

Microsoft.Exchange.Data.Directory.Management.UMMailbox

Dieser Parameter gibt den Objekteingabeparameter an. Der Parameter Instance ist erforderlich, wenn der Parameter Identity nicht verwendet wird.

MissedCallNotificationEnabled

Optional

System.Boolean

Dieser Parameter gibt an, ob Benachrichtigungen über verpasste Anrufe gesendet werden sollen.

Name

Optional

System.String

Dieser Parameter gibt den Anzeigenamen für den Benutzer an. Der Anzeigename darf maximal 64 Zeichen lang sein.

OperatorNumber

Optional

System.String

Dieser Parameter gibt die Zeichenfolge aus Zahlen für die persönliche Vermittlungsstelle an.

SubscriberAccessEnabled

Optional

System.Boolean

Dieser Parameter gibt an, ob dem Benutzer der Teilnehmerzugriff auf sein eigenes Postfach gewährt werden soll. Wenn dieser Parameter auf $true festgelegt ist, können Benutzer, nachdem sie sich authentifiziert haben, Voicemail über das Telefon abrufen.

TUIAccessToAddressBookEnabled

Optional

System.Boolean

Dieser Parameter gibt an, ob ein Benutzer über das Telefon auf die Verzeichnis- und Kontaktinformationen zugreifen kann.

TUIAccessToCalendarEnabled

Optional

System.Boolean

Dieser Parameter gibt an, ob Benutzer über das Telefon auf ihre eigenen Kalenderinformationen zugreifen können.

TUIAccessToEmailEnabled

Optional

System.Boolean

Dieser Parameter gibt an, ob Benutzer über das Telefon auf ihre eigenen E-Mails zugreifen können.

UMMailboxPolicy

Optional

Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter

Dieser Parameter gibt die UM-Postfachrichtlinie an, die dem Postfach des UM-aktivierten Benutzers zugeordnet ist.

UseRusServer

Optional

System.String
noteHinweis:
Dieser Parameter steht nur in Exchange 2007 SP2 zur Verfügung.

Der Parameter UseRusServer weist den Befehl an, den angegebenen Postfachserver, auf dem der Adresslistendienst ausgeführt wird, zum Abrufen und Festlegen von Postfach- und Active Directory-Benutzerattributen zu verwenden.

Der Adresslistendienst ist eine Komponente des Exchange-Systemaufsichtsdiensts. Der Adresslistendienst erstellt und verwaltet Exchange-spezifische Attributwerte in Active Directory. Sie können den Adresslistendienst zum Aktualisieren von Empfängerobjekten in einer Domäne mithilfe bestimmter Informationen verwenden, z. B. anhand von Adresslistenmitgliedschaft und E-Mail-Adressen.

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 sich ergebenden Änderungen anzeigen, ohne diese Änderungen tatsächlich auszuführen. Der Standardwert lautet "$true".

Eingabetypen

Typ Beschreibung

 

 

Rückgabetypen

Typ Beschreibung

 

 

Fehler

Fehler Beschreibung

 

 

Beispiel

Das erste Beispiel ändert die sekundäre Adresse und dem UM-Wählplan für yanli@contoso.com.

Das zweite Beispiel verhindert, dass Benutzer auf ihren Kalender und ihre E-Mail-Nachrichten zugreifen, wenn sie Outlook Voice Access verwenden.

Das dritte Beispiel ändert die Eigenschaften eines UM-Postfachs für yanli@contoso.com.

Set-UMMailbox -Identity yanli@contoso.com

Set-UMMailbox -Identity yanli@contoso.com -TUIAccessToCalendarEnabled $false -TUIAccessToEmailEnabled $false

Set-UMMailbox -Identity yanli@contoso.com -UMMailboxPolicy MyUMMailboxPolicy -FaxEnabled $true