Update-Recipient
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2007-07-18
Verwenden Sie das Cmdlet Update-Recipient zum Hinzufügen von Microsoft Exchange Server 2007-Attributen zu Empfängerobjekten, die vom Agent für die Verwaltung der Synchronisierung globaler Adresslisten (GAL) in Identity Lifecycle Manager 2007 (ILM) erstellt wurden. Die Empfängerobjekte, die Sie mithilfe dieses Cmdlets ändern, müssen sich auf einem Exchange 2007-Server befinden.
Syntax
Update-Recipient -Identity <RecipientIdParameter> [-Confirm [<SwitchParameter>]] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Aufgrund von Fusionen und Übernahmen oder gesetzlichen Anforderungen müssen Kunden ggf. Exchange in einer Topologie mit mehreren Exchange-Gesamtstrukturen implementieren. Diese Implementierungen setzen die Synchronisierung von Empfängerobjekten über verschiedene Gesamtstrukturen des Verzeichnisdienstes Active Directory voraus. Weitere Informationen über Topologien mit mehreren Exchange-Gesamtstrukturen finden Sie unter Planung für eine komplexe Exchange-Organisation.
Microsoft stellt einen Agent für die Verwaltung der Synchronisierung globaler Adresslisten (GAL) für die Synchronisierung von Empfängerobjekten bereit. Die Version des Agents für die Verwaltung der Synchronisierung globaler Adresslisten (GAL), die zum Lieferumfang von Microsoft Identity Integration Server (MIIS) 2003 gehört, wurde für die Zusammenarbeit mit Exchange Server 2003 entwickelt und setzte auf Empfängeraktualisierungsdienst (Recipient Update Service, RUS) auf. Da es sich bei RUS um eine verworfene Funktion handelt, die für Exchange 2007 nicht mehr benötigt wird, ist der neue Agent für die Verwaltung der Synchronisierung globaler Adresslisten (GAL), der zum Lieferumfang von ILM 2007 gehört, so ausgelegt, dass er ohne RUS funktioniert.
Als Teil des Synchronisierungsprozesses erstellt der Agent für die Verwaltung der Synchronisierung globaler Adresslisten (GAL) von ILM 2007 Empfängerobjekte in beiden Active Directory-Gesamtstrukturen. Nachdem die Empfänger erstellt wurden, verwendet der Verwaltungs-Agent das Cmdlet Update-Recipient zum Hinzufügen der Attribute, die von Exchange 2007 benötigt werden, um die Bereitstellung dieser Empfänger abzuschließen.
Hinweis
Wenn Sie mit MIIS 2003 arbeiten, müssen Sie verschiedene Cmdlets ausführen, um den Bereitstellungsprozess für die E-Mail-Kontakte abzuschließen, die vom Agent für die Verwaltung der Synchronisierung globaler Adresslisten (GAL) erstellt wurden. Detaillierte Informationen zur Bereitstellung von E-Mail-Kontakten, die von MIIS 2003 erstellt wurden, finden Sie unter Bereitstellen von Exchange 2007 in einer gesamtstrukturübergreifenden Topologie. Das Cmdlet Update-Recipient stellt eine alternative und gleichzeitig effizientere Methode bereit, um dies zu erreichen. Für den Abschluss des Bereitstellungsprozesses können Sie einfach das Cmdlet Update-Recipient für die Empfängerobjekte ausführen, die vom Agent für die Verwaltung der Synchronisierung globaler Adresslisten (GAL) von MIIS 2003 erstellt wurden.
Damit Sie das Cmdlet Update-Recipient ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:
- die Rolle Exchange-Empfängeradministrator
Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Exchange 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter |
Der Parameter Identity identifiziert den Empfänger. Einer der folgenden Werte kann verwendet werden:
|
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. |
Credential |
Optional |
System.Management.Automation.PSCredential |
Der Parameter Credential gibt den zu verwendenden Benutzernamen und das Kennwort für den Zugriff auf Active Directory an. Wenn der Parameter Credential verwendet wird, fordert der Befehl vor dem Fortfahren zur Eingabe des Kontokennworts auf. |
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. |
Server |
Optional |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Der Parameter Server gibt den Server an, auf dem die ausgewählten Vorgänge ausgeführt werden sollen. |
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 |
|---|---|
|
Beispiel
Im ersten Beispiel wird gezeigt, wie das Cmdlet Update-Recipient zum Hinzufügen von Exchange 2007-Attributen zu dem E-Mail-Kontakt verwendet wird, der das Postfach von John Smith repräsentiert.
Im zweiten Beispiel wird gezeigt, wie alle Kontakte in einer bestimmten Organisationseinheit (OU) aktualisiert werden. In diesem Beispiel wird davon ausgegangen, dass Empfänger zwischen zwei Gesamtstrukturen, contoso.com und fabrikam.com, synchronisiert werden und dass alle synchronisierten Empfänger aus der Domäne fabrikam.com in einer bestimmten OU mit Namen fabrikam.com Users in der Domäne contoso.com gespeichert werden.
Update-Recipient -Identity "John Smith"
Get-MailContact -OrganizationalUnit "contoso.com/fabrikam.com Users" | Update-Recipient