Set-Contact

  • 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 Set-Contact können Sie die Einstellungen eines vorhandenen Kontakts ändern.

Syntax

Set-Contact -Identity <ContactIdParameter> [-AllowUMCallsFromNonUsers <None | SearchEnabled>] [-AssistantName <String>] [-City <String>] [-Company <String>] [-Confirm [<SwitchParameter>]] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-IgnoreDefaultScope <SwitchParameter>] [-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>] [-UseRusServer <String>] [-WebPage <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Set-Contact [-AllowUMCallsFromNonUsers <None | SearchEnabled>] [-AssistantName <String>] [-City <String>] [-Company <String>] [-Confirm [<SwitchParameter>]] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-IgnoreDefaultScope <SwitchParameter>] [-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>] [-UseRusServer <String>] [-WebPage <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

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.

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

  • GUID

  • Distinguished Name (DN)

  • Kanonischer Name

  • Name

Der Parameter Identity kann nicht zusammen mit dem Parameter Instance verwendet werden.

AllowUMCallsFromNonUsers

Optional

Microsoft.Exchange.Data.Directory.Recipient.AllowUMCallsFromNonUsersFlags

Dieser Parameter gibt an, ob der Kontakt von Verzeichnissuchen ausgeschlossen werden soll.

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.

Confirm

Optional

System.Management.Automation.SwitchParameter

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

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.

IgnoreDefaultScope

Optional

System.Management.Automation.SwitchParameter

Mit dem Parameter IgnoreDefaultScope 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.

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 gesamten Objekts an den zu verarbeitenden Befehl. Er wird hauptsächlich in Skripts verwendet, in denen ein gesamtes 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 Parameterwert Name kann maximal 64 Zeichen umfassen.

Notes

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 folgenden Zeichen:

abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\"()+,-./:?

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.

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.

WebPage

Optional

System.String

Der Parameter WebPage gibt die Webseite des Kontakts an.

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 Parameters WhatIf können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Für den Parameter WhatIf muss kein Wert angegeben werden.

WindowsEmailAddress

Optional

Microsoft.Exchange.Data.SmtpAddress

Der Parameter WindowsEmailAddress gibt die E-Mail-Adresse des Kontakts an, die in Active Directory gespeichert ist.

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"