• Artikel

Move-CsExUmContact

 

Letztes Änderungsdatum des Themas: 2012-03-23

Verschiebt einen oder mehrere Exchange Unified Messaging (UM)-Kontakte in einen neuen Registrierungspool.

Syntax

Move-CsExUmContact -Identity <UserIdParameter> -Target <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-ProxyPool <Fqdn>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Microsoft Lync Server 2010 wird mit Exchange UM eingesetzt, um verschiedene VoIP-bezogene Funktionen wie automatische Telefonzentralen oder den Teilnehmerzugriff bereitzustellen. Mit Move-CsExUmContact können Sie ein vorhandenes Exchange UM-Kontaktobjekt in einen neuen Registrierungspool verschieben. Kontaktobjekte können von einem Microsoft Office Communications Server 2007- oder Microsoft Office Communications Server 2007 R2-Pool in einen Lync Server 2010-Pool oder von einem Lync Server 2010-Pool in einen anderen verschoben werden. Mit diesem Cmdlet ist es nicht möglich, ein Exchange UM-Kontaktobjekt von einem Lync Server 2010-Pool in einen Office Communications Server 2007- oder Office Communications Server 2007 R2-Pool zu verschieben.

Beim Verschieben eines Exchange UM-Kontaktobjekts werden die Eigenschaften "AutoAttendant" und "IsSubscriberAccess" basierend auf dem Wert der Eigenschaft "OtherIpPhone" des Objekts festgelegt.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Move-CsExUmContact lokal auszuführen: RTCUniversalUserAdmins. Geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein, um eine Liste aller rollenbasierten Zugriffssteuerungsrollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich der benutzerdefinierten rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Move-CsExUmContact"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

UserIdParameter

Die eindeutige ID für das Kontaktobjekt, das verschoben werden soll. Kontaktidentitäten können in den folgenden vier Formaten angegeben werden: als 1) SIP-Adresse des Kontakts, 2) UPN (User Principal Name) des Kontakts, 3) Domänen- und Anmeldename des Kontakts (mit dem Format "Domäne\Anmeldename", z. B. "litwareinc\exum1") und 4) Anzeigename des Kontakts in Active Directory (z. B. "Team Auto Attendant").

Target

Erforderlich

FQDN

Der vollqualifizierte Domänenname (FQDN) des Registrierungspools, in den der Kontakt verschoben wird.

Confirm

Optional

Switch-Parameter

Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf.

DomainController

Optional

FQDN

Ermöglicht die Verbindungsherstellung mit dem angegebenen Domänencontroller. Zum Herstellen einer Verbindung mit einem bestimmten Domänencontroller nehmen Sie den Parameter "DomainController" auf und geben anschließend den Computernamen (z. B. "atl-mcs-001") oder den vollqualifizierten Domänennamen (z. B. "atl-mcs-001.litwareinc.com") an.

Force

Optional

Switch-Parameter

Unterdrückt alle Bestätigungsaufforderungen, die andernfalls vor der Durchführung von Änderungen angezeigt würden.

PassThru

Optional

Switch-Parameter

Ermöglicht das Übergeben eines Kontaktobjekts für das Kontaktkonto, das verschoben wird. Das Cmdlet Move-CsExUmContact leitet standardmäßig keine Objekte weiter.

ProxyPool

Optional

FQDN

Dieser Parameter wird nur für gehostete Instanzen von Lync Server verwendet. Er sollte nicht mit einer lokalen Implementierung von Lync Server verwendet werden.

WhatIf

Optional

Switch-Parameter

Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.

Eingabetypen

Zeichenfolge. Akzeptiert einen weitergeleiteten Zeichenfolgenwert, der die Identität eines Exchange UM-Objekts repräsentiert.

Rückgabetypen

Bei Aufruf mit dem Parameter "PassThru" wird ein Objekt vom Typ "Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact" zurückgegeben.

Beispiel

-------------------------- Beispiel 1 -------------------------

Move-CsExUmContact -Identity "sip:exum1@fabrikam.com" -Target atl-cs-001.litwareinc.com

In Beispiel 1 wird das Exchange UM-Kontaktobjekt mit der SIP-Adresse "exum1@fabrikam.com" in den Registrierungspool mit dem FQDN "atl-cs-001.litwareinc.com" verschoben. Beachten Sie, dass bei Ausführung dieses Befehls eine Bestätigungsaufforderung angezeigt wird, obwohl der Parameter "Confirm" nicht eingeschlossen wurde. Diese Bestätigungsaufforderung wird sogar dann angezeigt, wenn Sie den Parameter "Force" einschließen.

-------------------------- Beispiel 2 -------------------------

Get-CsExUmContact | Where-Object {$_.AutoAttendant -eq $True} | Move-CsExUmContact -Target atl-cs-001.litwareinc.com

In diesem Beispiel werden alle Exchange UM-Kontaktobjekte verschoben, bei denen es sich um automatische Telefonzentralen für den Registrierungspool mit dem FQDN "atl-cs-001.litwareinc.com" handelt. Das Beispiel beginnt mit einem Aufruf von Get-CsExUmContact, wodurch alle definierten Exchange UM-Kontakte abgerufen werden. Diese Auflistung von Kontakten wird anschließend an das Cmdlet Where-Object weitergeleitet, dass alle Kontakte in der Auflistung ermittelt, deren Eigenschaft "AutoAttendant" den Wert "True" ($True) aufweist. Dies bedeutet, dass es sich bei dem Kontakt um eine automatische Telefonzentrale handelt.

Abschließend wird die Auflistung von Kontakten, bei denen "AutoAttendant" auf "True" festgelegt ist, an das Cmdlet Move-CsExUmContact weitergeleitet, das die Kontakte in den im Parameter "Target" angegebenen Registrierungspool verschiebt.

Wie in Beispiel 1 erhalten Sie bei Ausführung dieses Befehls eine Bestätigungsaufforderung.