Set-User (RTM)
Gilt für: Exchange Server 2007
Letztes Änderungsdatum des Themas: 2007-06-05
Verwenden Sie das Cmdlet Set-User, um Benutzerattribute im Active Directory-Verzeichnisdienst zu ändern.
Syntax
set-User -Identity <UserIdParameter> [-AssistantName <String>] [-City <String>] [-Company <String>] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-Initials <String>] [-LastName <String>] [-Manager <UserContactIdParameter>] [-MobilePhone <String>] [-Name <String>] [-Notes <String>] [-Office <String>] [-OtherFax <MultiValuedProperty>] [-OtherHomePhone <MultiValuedProperty>] [-OtherTelephone <MultiValuedProperty>] [-Pager <String>] [-Phone <String>] [-PhoneticDisplayName <String>] [-PostalCode <String>] [-PostOfficeBox <MultiValuedProperty>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UserPrincipalName <String>] [-WebPage <String>] [-WindowsEmailAddress <SmtpAddress>]
set-User [-AssistantName <String>] [-City <String>] [-Company <String>] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-Initials <String>] [-Instance <User>] [-LastName <String>] [-Manager <UserContactIdParameter>] [-MobilePhone <String>] [-Name <String>] [-Notes <String>] [-Office <String>] [-OtherFax <MultiValuedProperty>] [-OtherHomePhone <MultiValuedProperty>] [-OtherTelephone <MultiValuedProperty>] [-Pager <String>] [-Phone <String>] [-PhoneticDisplayName <String>] [-PostalCode <String>] [-PostOfficeBox <MultiValuedProperty>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UserPrincipalName <String>] [-WebPage <String>] [-WindowsEmailAddress <SmtpAddress>]
Detaillierte Beschreibung
Mit dem Cmdlet Set-User werden die Attribute eines vorhandenen Benutzers in Active Directory geändert.
Damit Sie das Cmdlet Set-User ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:
die Rolle Exchange-Empfängeradministrator
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 Exchange Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
Microsoft.Exchange.Configuration.Tasks.UserIdParameter |
Der Parameter Identity akzeptiert einen der folgenden Werte:
|
AssistantName |
Optional |
System.String |
Der Parameter AssistantName definiert den Namen des Assistenten des Benutzers. |
City |
Optional |
System.String |
Der Parameter City definiert den Ort des Benutzers. |
Company |
Optional |
System.String |
Der Parameter Company definiert das Unternehmen des Benutzers. |
CountryOrRegion |
Optional |
Microsoft.Exchange.Data.Directory.CountryInfo |
Der Parameter CountryOrRegion definiert das Land oder die Region des Benutzers. |
CreateDTMFMap |
Optional |
System.Boolean |
Dieser Parameter gibt an, dass eine DTMF-Zuordnung (Dual Tone Multi-Frequency) für den Benutzer erstellt werden soll. |
Department |
Optional |
System.String |
Der Parameter Department definiert die Abteilung des Benutzers. |
DisplayName |
Optional |
System.String |
Der Parameter DisplayName definiert den Anzeigenamen des Benutzers. |
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. |
Fax |
Optional |
System.String |
Der Parameter Fax definiert die Faxnummer des Benutzers. |
FirstName |
Optional |
System.String |
Der Parameter FirstName definiert den Vornamen des Benutzers. |
HomePhone |
Optional |
System.String |
Der Parameter HomePhone definiert die private Telefonnummer des Benutzers. |
Initials |
Optional |
System.String |
Der Parameter Initials definiert die Initialen des Benutzers. |
Instance |
Optional |
Microsoft.Exchange.Data.Directory.Management.User |
Der Parameter Instance ermöglicht das Übergeben eines vollständigen Objekts an den zu verarbeitenden Befehl. Er wird hauptsächlich in Skripts verwendet, in denen ein vollständiges Objekt an den Befehl übergeben werden muss. |
LastName |
Optional |
System.String |
Der Parameter LastName definiert den Nachnamen des Benutzers. |
Manager |
Optional |
Microsoft.Exchange.Configuration.Tasks.UserContactIdParameter |
Der Parameter Manager definiert den Vorgesetzten des Benutzers. |
MobilePhone |
Optional |
System.String |
Der Parameter MobilePhone definiert die primäre Mobiltelefonnummer des Benutzers. |
Name |
Optional |
System.String |
Der Parameter Name definiert den allgemeinen Namen des Benutzers. |
Notizen |
Optional |
System.String |
Der Parameter Notes definiert zusätzliche Informationen über den Benutzer. |
Office |
Optional |
System.String |
Der Parameter Office definiert den Namen oder die Nummer des physikalischen Büroraums des Benutzers. |
OtherFax |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Der Parameter OtherFax definiert die alternative Faxnummer des Benutzers. |
OtherHomePhone |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Der Parameter OtherHomePhone definiert die alternative private Telefonnummer des Benutzers. |
OtherTelephone |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Der Parameter OtherTelephone definiert die alternative Telefonnummer des Benutzers. |
Pager |
Optional |
System.String |
Der Parameter Pager definiert die Pagernummer des Benutzers. |
Phone |
Optional |
System.String |
Der Parameter Phone definiert die geschäftliche Telefonnummer des Benutzers. |
PhoneticDisplayName |
Optional |
System.String |
Der Parameter PhoneticDisplayName gibt eine phonetische Aussprache des Parameters DisplayName an. Dieser Parameterwert kann höchstens 255 Zeichen umfassen. Weitere Informationen zum Parameter PhoneticDisplayName und der Spracherkennung finden Sie unter Informationen über Verzeichnissuchen bei der automatischen Spracherkennung. |
PostalCode |
Optional |
System.String |
Der Parameter PostalCode definiert die Postleitzahl des Benutzers. |
PostOfficeBox |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Der Parameter PostOfficeBox definiert die Postfachnummer des Benutzers. |
ResetPasswordOnNextLogon |
Optional |
System.Boolean |
Der Parameter ResetPasswordOnNextLogon gibt an, ob das im Parameter Password angegebene Kennwort bei der nächsten Anmeldung des Benutzers zurückgesetzt werden muss. Der Standardwert lautet "$true". |
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. |
SimpleDisplayName |
Optional |
System.String |
Der Parameter SimpleDisplayName dient zum Anzeigen einer alternativen Beschreibung des Objekts, wenn nur eine begrenzte Menge von Zeichen zulässig ist. Diese begrenzte Zeichenmenge umfasst die ASCII-Zeichen 26 bis (einschließlich) 126. |
StateOrProvince |
Optional |
System.String |
Der Parameter StateOrProvince definiert das Bundesland oder den Kanton des Benutzers. |
StreetAddress |
Optional |
System.String |
Der Parameter StreetAddress definiert die physikalische Adresse des Benutzers. |
Title |
Optional |
System.String |
Der Parameter Title definiert den Titel des Benutzers. |
UMDialPlan |
Optional |
Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter |
Dieser Parameter gibt die Verzeichnisobjekt-ID für den Wählplan an. |
UMDtmfMap |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Dieser Parameter gibt an, ob Sie eine benutzerdefinierte DTMF-Zuordnung für den UM-aktivierten Benutzer erstellen möchten. |
UserPrincipalName |
Optional |
System.String |
Der Parameter UserPrincipalName definiert den UPN (Universal Principal Name) des Benutzers. |
WebPage |
Optional |
System.String |
Der Parameter WebPage definiert die Webseite des Benutzers. |
WindowsEmailAddress |
Optional |
Microsoft.Exchange.Data.SmtpAddress |
Der Parameter WindowsEmailAddress gibt die E-Mail-Adresse des Empfängers an. |
Eingabetypen
Rückgabetypen
Fehler
| Fehler | Beschreibung |
|---|---|
|
|
Ausnahmen
| Ausnahmen | Beschreibung |
|---|---|
|
|
Beispiel
Im folgenden Beispiel wird das Cmdlet Set-User verwendet, um den Anzeigenamen für den Benutzer Ted Bremer festzulegen.
Set-User -Identity Contoso\Ted -DisplayName "Ted Bremer"