Set-Contact (RTM)
Gilt für: Exchange Server 2007
Letztes Änderungsdatum des Themas: 2007-06-17
Mithilfe des Cmdlets Set-Contact können Sie die Einstellungen eines vorhandenen Kontakts ändern.
Syntax
Set-Contact -Identity <ContactIdParameter> [-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>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-WebPage <String>]
Set-Contact [-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 <Contact>] [-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>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-WebPage <String>]
Detaillierte Beschreibung
Mithilfe des Cmdlets Set-Contact können Sie die Einstellungen von Kontaktobjekten ändern, die in Active Directory-Benutzer und -Computer angezeigt werden. Wenn der Kontakt E-Mail-aktiviert ist, verwenden Sie das Cmdlet ** Set-MailContact** zum Ändern der E-Mail-Einstellungen des Kontakts, auf die mithilfe des Cmdlets Set-Contact nicht zugegriffen werden kann. Weitere Informationen zum Cmdlet Set-MailContact finden Sie unter Set-MailContact (RTM).
Damit Sie das Cmdlet Set-Contact 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.ContactIdParameter |
Der Parameter Identity gibt das zu ändernde Objekt an. Der Parameter Identity akzeptiert jeden der folgenden Werte für das Kontaktobjekt:
Der Parameter Identity kann nicht zusammen mit dem Parameter Instance verwendet werden. |
AssistantName |
Optional |
System.String |
Der Parameter AssistantName gibt den Namen des Assistenten des Kontakts an. |
City |
Optional |
System.String |
Der Parameter City gibt den Ort des Kontakts an. |
Company |
Optional |
System.String |
Der Parameter Company gibt das Unternehmen des Kontakts an. |
CountryOrRegion |
Optional |
Microsoft.Exchange.Data.Directory.CountryInfo |
Der Parameter CountryOrRegion gibt das Land oder die Region des Kontakts an. |
CreateDTMFMap |
Optional |
System.Boolean |
Dieser Parameter gibt an, dass eine DTMF-Zuordnung (Dual Tone Multi-Frequency) für den Kontakt erstellt werden soll. |
Department |
Optional |
System.String |
Der Parameter Department gibt die Abteilung des Kontakts an. |
DisplayName |
Optional |
System.String |
Mithilfe des Parameters DisplayName können Sie den Namen des Kontakts in der Exchange-Verwaltungskonsole und in der globalen Exchange-Adressliste (GAL) angeben. DisplayName ist nur für E-Mail-aktivierte Objekte gültig. |
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 den Active Directory-Verzeichnisdienst schreibt, fügen Sie den Parameter DomainController hinzu. |
Fax |
Optional |
System.String |
Der Parameter Fax gibt die Faxnummer des Kontakts an. |
FirstName |
Optional |
System.String |
Der Parameter FirstName gibt den Vornamen des Kontakts an. |
HomePhone |
Optional |
System.String |
Der Parameter HomePhone gibt die private Telefonnummer des Kontakts an. |
Initials |
Optional |
System.String |
Der Parameter Initials gibt die Initialen des Kontaktnamens an. |
Instance |
Optional |
Microsoft.Exchange.Data.Directory.Management.Contact |
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. Der Parameter Instance kann nicht zusammen mit dem Parameter Identity verwendet werden. |
LastName |
Optional |
System.String |
Der Parameter LastName gibt den Nachnamen des Kontakts an. |
Manager |
Optional |
Microsoft.Exchange.Configuration.Tasks.UserContactIdParameter |
Der Parameter Manager gibt den Manager des Kontakts an. |
MobilePhone |
Optional |
System.String |
Der Parameter MobilePhone gibt die primäre Mobiltelefonnummer des Kontakts an. |
Name |
Optional |
System.String |
Der Parameter Name gibt den Namen des Kontakts in Active Directory-Benutzer und -Computer und im Feld Gruppenname in der Exchange-Verwaltungskonsole an, wenn es sich um eine E-Mail-aktivierte Gruppe handelt. Der Wert Name darf 64 Zeichen nicht überschreiten. |
Notizen |
Optional |
System.String |
Der Parameter Notes gibt zusätzliche Informationen zum Kontakt an. |
Office |
Optional |
System.String |
Der Parameter Office gibt den Namen oder die Nummer des physikalischen Büroraums des Kontakts an. |
OtherFax |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Der Parameter OtherFax gibt die alternative Faxnummer des Kontakts an. |
OtherHomePhone |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Der Parameter OtherHomePhone gibt die alternative private Telefonnummer des Kontakts an. |
OtherTelephone |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Der Parameter OtherTelephone gibt die alternative geschäftliche Telefonnummer des Kontakts an. |
Pager |
Optional |
System.String |
Der Parameter Pager gibt die Pagernummer des Kontakts an. |
Phone |
Optional |
System.String |
Der Parameter Phone gibt die geschäftliche Telefonnummer des Kontakts an. |
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 gibt die Postleitzahl des Kontakts an. |
PostOfficeBox |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Der Parameter PostOfficeBox gibt die Postfachnummer des Kontakts an. |
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. SimpleDisplayName ist nur für E-Mail-aktivierte Objekte gültig. |
StateOrProvince |
Optional |
System.String |
Der Parameter StateOrProvince gibt das Bundesland oder Kanton des Kontakts an. |
StreetAddress |
Optional |
System.String |
Der Parameter StreetAddress gibt die physikalische Adresse des Kontakts an. |
TelephoneAssistant |
Optional |
System.String |
Der Parameter TelephoneAssistant gibt die Telefonnummer des Assistenten des Kontakts an. |
Title |
Optional |
System.String |
Der Parameter Title gibt den Titel des Kontakts an. |
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 Kontakt erstellen möchten. |
WebPage |
Optional |
System.String |
Der Parameter WebPage gibt die Webseite des Kontakts an. |
Eingabetypen
Rückgabetypen
Fehler
| Fehler | Beschreibung |
|---|---|
|
|
Ausnahmen
| Ausnahmen | Beschreibung |
|---|---|
|
|
Beispiel
Das folgende Codebeispiel zeigt, wie der Befehl Set-Contact verwendet wird, um die folgenden Änderungen an einem vorhandenen Kontakt namens "Ted Bremer" im Benutzercontainer (Users) in der Active Directory-Domäne mit dem Namen contoso.com vorzunehmen:
Ändern des Werts von City in "Seattle"
Ändern des Werts von Company in "Contoso"
Set-Contact -Identity "contoso.com/Users/Ted Bremer" -City "Seattle" -Company "Contoso"