New-MailUser

  • Artikel

 

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

Letztes Änderungsdatum des Themas: 2009-05-12

Mithilfe des Cmdlets New-MailUser können Sie einen neuen E-Mail-aktivierten Benutzer erstellen.

Syntax

New-MailUser -Name <String> -ExternalEmailAddress <ProxyAddress> -Password <SecureString> -UserPrincipalName <String> [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-MacAttachmentFormat <BinHex | UuEncode | AppleSingle | AppleDouble>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-PrimarySmtpAddress <SmtpAddress>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UsePreferMessageFormat <$true | $false>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Das Cmdlet New-MailUser erstellt ein neues E-Mail-aktiviertes Benutzerobjekt im Active Directory-Verzeichnisdienst.

Damit Sie das Cmdlet New-MailUser ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:

  • Exchange-Empfängeradministrator-Rolle

  • Konten-Operator-Rolle für die entsprechenden Active Directory-Container

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.

Hinweis

Mit dem Cmdlet New-MailUser können nicht alle Benutzerattribute festgelegt werden. Weitere Einstellungen können mit dem Cmdlet Set-User vorgenommen werden.

Parameter

Parameter Erforderlich Typ Beschreibung

ExternalEmailAddress

Erforderlich

Microsoft.Exchange.Data.ProxyAddress

Der Parameter ExternalEmailAddress gibt eine E-Mail-Adresse außerhalb der Organisation an. E-Mail-Nachrichten, die an den E-Mail-aktivierten Benutzer gesendet werden, werden an diese externe Adresse übermittelt.

Name

Erforderlich

System.String

Der Parameter Name gibt den allgemeinen Namen des E-Mail-aktivierten Benutzers an.

Password

Erforderlich

System.Security.SecureString

Der Parameter Password gibt das Kennwort an, das der E-Mail-Benutzer zum Sichern seines Kontos verwendet.

UserPrincipalName

Erforderlich

System.String

Der Parameter UserPrincipalName definiert den Namen des Systembenutzers in einem E-Mail-Adressformat (z. B. ted@contoso.com).

Alias

Optional

System.String

Der Parameter Alias gibt den Alias des Benutzers an. Ein Alias kann Buchstaben, Zahlen sowie folgende Satzzeichen und Symbole enthalten:

  • !

  • #

  • $

  • %

  • ^

  • &

  • *

  • +

  • -

  • .

  • /

  • =

  • ?

  • _

  • {

  • }

  • |

  • ~

Confirm

Optional

System.Management.Automation.SwitchParameter

Der Confirm-Parameter bewirkt eine Unterbrechung der Befehlsausführung und zwingt Sie, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Für den Confirm-Parameter muss kein Wert angegeben werden.

DisplayName

Optional

System.String

Der Parameter DisplayName gibt den Namen an, der für den E-Mail-Benutzer in Microsoft Outlook angezeigt wird.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Um den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers anzugeben, der diese Konfigurationsänderung in Active Directory schreibt, fügen Sie dem Befehl den Parameter DomainController hinzu.

FirstName

Optional

System.String

Der Parameter FirstName gibt den Vornamen des E-Mail-Benutzers an.

Initials

Optional

System.String

Der Parameter Initials gibt die Initialen des E-Mail-Benutzers an.

LastName

Optional

System.String

Der Parameter LastName gibt den Nachnamen des E-Mail-Benutzers an.

MacAttachmentFormat

Optional

Microsoft.Exchange.Data.Directory.Recipient.MacAttachmentFormat

Der Parameter MacAttachmentFormat gibt das Anlagenformat des Apple Macintosh-Betriebssystems für Nachrichten an, die an den E-Mail-Benutzer gesendet werden. Gültige Werte für diesen Parameter:

  • BinHex

  • UUENCODE

  • AppleSingle

  • AppleDouble

Standardmäßig ist dieser Parameter auf BinHex festgelegt. Die akzeptablen Werte für den MacAttachmentFormat-Parameter hängen vom Wert des MessageFormat-Parameters ab. Wenn der MessageFormat-Parameter auf Text festgelegt ist, können nur die Werte BinHex oder UUENCODE für diesen Parameter verwendet werden. Wenn der MessageFormat-Parameter auf Mime festgelegt ist, können nur die Werte BinHex, AppleSingle oder AppleDouble für diesen Parameter verwendet werden.

MessageBodyFormat

Optional

Microsoft.Exchange.Data.Directory.Recipient.MessageBodyFormat

Der Parameter MessageBodyFormat gibt das Format des Nachrichtentexts für Nachrichten an, die an den E-Mail-Benutzer gesendet werden. Gültige Werte für diesen Parameter:

  • Text

  • Html

  • TextAndHtml

Standardmäßig ist dieser Parameter auf TextAndHtml festgelegt.

Für die Parameter MessageFormat und MessageBodyFormat bestehen gegenseitige Abhängigkeiten. Wenn der MessageFormat-Parameter auf Mime festgelegt ist, kann der MessageBodyFormat-Parameter auf jeden gültigen Wert festgelegt werden. Wenn der MessageFormat-Parameter jedoch auf Text festgelegt ist, kann der MessageBodyFormat-Parameter nur auf Text festgelegt werden. Wenn Sie diesen Parameter auf Html oder TextAndHtml festlegen möchten, müssen Sie daher auch den MessageFormat-Parameter auf Mime festlegen.

MessageFormat

Optional

Microsoft.Exchange.Data.Directory.Recipient.MessageFormat

Der Parameter MessageFormat gibt das Nachrichtenformat für Nachrichten an, die an den E-Mail-Benutzer gesendet werden.

Gültige Werte für diesen Parameter:

  • Text

  • Mime

Standardmäßig ist dieser Parameter auf Mime festgelegt.

Für die Parameter MessageFormat und MessageBodyFormat bestehen gegenseitige Abhängigkeiten. Wenn der MessageFormat-Parameter auf Mime festgelegt ist, kann der MessageBodyFormat-Parameter auf jeden gültigen Wert festgelegt werden. Wenn der MessageFormat-Parameter jedoch auf Text festgelegt ist, kann der MessageBodyFormat-Parameter nur auf Text festgelegt werden. Wenn Sie den MessageFormat-Parameter von Mime in Text ändern möchten, müssen Sie daher auch den MessageBodyFormat-Parameter in Text ändern.

OrganizationalUnit

Optional

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Der Parameter OrganizationalUnit gibt die Organisationseinheit an, der der neue Benutzer hinzugefügt werden soll (z. B. redmond.contoso.com/contacts).

PrimarySmtpAddress

Optional

Microsoft.Exchange.Data.SmtpAddress

Verwenden Sie diesen Parameter, um die primäre SMTP-Adresse für den E-Mail-Benutzer anzugeben. Standardmäßig wird die primäre SMTP-Adresse basierend auf der E-Mail-Standardadressrichtlinie generiert. Wenn Sie mithilfe dieses Parameters eine primäre SMTP-Adresse angeben, legt das Cmdlet das Attribut EmailAddressPolicyEnabled des E-Mail-Benutzers auf $false fest, und die E-Mail-Adressen dieses E-Mail-Benutzers werden nicht automatisch basierend auf den E-Mail-Richtlinien aktualisiert.

ResetPasswordOnNextLogon

Optional

System.Boolean

Wenn der Parameter ResetPasswordOnNextLogon auf $true festgelegt ist, muss der Benutzer das Kennwort bei der nächsten Anmeldung ändern.

SamAccountName

Optional

System.String

Der Parameter SamAccountName definiert den Anmeldenamen, der zur Unterstützung von Clients und Servern mit älteren Versionen des Betriebssystems, wie zum Beispiel Microsoft Windows NT 4.0, Windows 98, Windows 95 oder LAN Manager, verwendet wird. Dieses Attribut darf maximal 19 Zeichen lang sein. Ein Kontoname kann Buchstaben, Zahlen sowie folgende Satzzeichen und Symbole enthalten:

  • !

  • #

  • $

  • %

  • ^

  • &

  • -

  • .

  • _

  • {

  • }

  • |

  • ~

TemplateInstance

Optional

System.Management.Automation.PSObject

Wenn ein vorhandenes Objekt an den Parameter TemplateInstance übergeben wird, verwendet der Befehl die Konfiguration dieses Objekts zum Erstellen eines genauen Duplikats des Objekts auf einem lokalen oder Zielserver.

UsePreferMessageFormat

Optional

System.Boolean

Der Parameter UsePreferMessageFormat gibt an, ob die für das Postfach konfigurierten Nachrichtenformateinstellungen die für die Domäne konfigurierten globalen Einstellungen außer Kraft setzen. Legen Sie diesen Parameter auf $true fest, damit die für das Postfach konfigurierten Nachrichtenformateinstellungen alle globalen Einstellungen außer Kraft setzen.

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

Der Parameter WhatIf weist den Befehl an, die für das Objekt ausgeführten Aktionen lediglich zu simulieren. Durch Verwendung des WhatIf-Parameters können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Für den WhatIf-Parameter muss kein Wert angegeben werden.

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

 

Ausnahmen

Ausnahmen Beschreibung

 

Beispiel

Das folgende Beispiel setzt sich aus zwei Befehlen zusammen.

Im ersten Befehl wird ein Kennwort $password vom Typ System.Security.SecureString erstellt. Bei der Ausführung des Befehls wird die Eingabeaufforderung "Enter password" angezeigt. Die vom Benutzer eingegebene Zeichenfolge wird zur neuen Kennwortzeichenfolge $password.

Mit dem zweiten Befehl wird ein neues E-Mail-aktiviertes Benutzerobjekt mit Namen Ted Bremer erstellt und diesem das neu erstellte Kennwort mithilfe des Parameters Password zugewiesen. Ted ist Mitarbeiter von Tailspin Toys, da er jedoch eng mit den Mitarbeitern von Contoso zusammenarbeitet, erhält er eine E-Mail-Adresse bei contoso.com. Ted verfügt jedoch nicht über ein Exchange Server-Postfach bei Contoso. E-Mail-Nachrichten, die an die Teds E-Mail-Adresse bei contoso.com gesendet werden, werden an seine externe E-Mail-Adresse, ted@tailspintoys.com, übermittelt.

$password = Read-Host "Enter password" -AsSecureString
New-MailUser -Name "Ted Bremer" -Password $password -ExternalEmailAddress ted@tailspintoys.com -UserPrincipalName ted@contoso.com -OrganizationalUnit contoso.com